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LIMITED WARRANTY 

In the unlikely event that the disk contained in this issue is 
defective in manufacture, return it within 30 days after 
purchase or receipt to PC Disk Magazine, 39 East Hanover 
Avenue, Morris Plains, NJ 07950, and it will be replaced at no 
charge. Merchandise for exchange must be accompanied by 
proof of purchase or a subscription label. 

The publisher shall have no liability or responsibility to any 
purchaser or subscriber or to any other person or entity with 
respect to any liability, loss or damage directly or indirectly 
arising out of the use of the disk and the programs contained 
in this issue, including, but not limited to, any loss of business 
or any other incidental or consequential damages. 


COPYRIGHT 

Programs and Documentation Copyright © 1983 Ziff-Davis 
Publishing Company. All rights of reproduction in all forms 
and media strictly reserved. 

The original purchaser/subscriber only is authorized to 
make copies solely for use in his/her own computer. 
Distribution, transmission, or transfer of copies to any other 
person is an infringement of copyright. 
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=== ROM THE EDITOR 


Welcome to PC Disk Magazine, the first computer magazine 
to regularly bring you ready-to-run software for your IBM Per- 
sonal Computer. In each issue you will find an editorial disk- 
ette containing programs, subroutines, and data files. The 


ery issue will contain new and original materials, PC Disk 
Magazine offers a unique opportunity for you to compile a li- 
brary of quality software at an attractive price. 


That all sounds great, but what exactly do you get? Our goal 
is to provide you with software that is useful in the broadest 
sense — software that performs practical tasks, software you 
can build on, software you can learn from, software that en- 
tertains and informs. We want to help you get the most out of 
your PC by providing the tools to expand and inspire the 
ways you use it. So we have gathered materials in such di- 
verse areas as business and finance, home and personal, 
programming tools, utilities, entertainment, and data files. 
Our editorial interests are intentionally broad so as to provide 
our readers with the greatest benefit: using PC Disk 
Magazine. 


Our desire to foster a spirit of participation in PC Disk Maga- 
zine goes beyond your use of it as a reader, because our 
readers are also our authors. We maintain an open submis- 
sion policy so, with PC Disk Magazine, any software author 
can profit directly from his/her work. At the same time, we 
can reach out to otherwise inaccessible software sources. If 
you have a program you think we might be interested in pub- 
lishing, we’d be delighted to see it. But before sending any 
materials, please read the Submission Procedure section in 
this manual. 


Whether you are a reader, an author, or both, the key to our 
success and your satisfaction is communication. Fill out the 
enclosed questionnaire so we can get to know you. And tell 
us what you think of the contents of this our premier issue. We 
look forward to hearing from you now and in the future, and 
hope you put your first issue of PC Disk Magazine to good 


use. 
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UBLISHING 
PHILOSOPHY 


A quick look at the editorial diskette for this premier issue of 
PC Disk Magazine reveals a fairly radical editorial decision: 
all ten BASIC programs have been published in original 
source code. Consequently, these programs can be listed 
and copied in their entirety. We at PC Disk Magazine have 
chosen neither to copy-protect our offerings, nor to make our 
program code inaccessible—a rather sharp departure from 
traditional software distribution. 


WHY? 

The most important reason behind our decision is our desire 
to make PC Disk Magazine of the greatest possible use to 
you. This desire involves several considerations. First, we 
want you to be able to learn from these programs. To do so 
you must be able to study the source code in order to under- 
stand the design concepts and programming techniques em- 
ployed. Second, we want you to be able to adapt these pro- 
grams to your own needs. You may choose to modify some 
programs, or expand them, or include them in programs of 
your own. Once again, you need the source code to do this. 
The third consideration is that to have the flexibility to use PC 
Disk Magazine most extensively, to modify and expand pro- 
grams, to create different versions and to experiment, you 
must be able to make copies of PC Disk Magazine materials. 
Thus, our objective—to establish the closest possible rela- 
tionship between this magazine and its readers—was the 
most compelling reason to publish copy-able source code. 


Another reason worth mentioning is space. The same pro- 
gram requires 10 to 50 percent less storage space on our 
editorial diskette in source code than it would in compiled 
BASIC. So publishing programs in source code lets us give 
you more software in the fixed amount of diskette space 
available. 


Now that you understand the reasons for our decision, we 
hope you will minimize our risk by honoring the legal copy re- 
strictions that apply to PC Disk Magazine. Use the magazine 
as extensively as you like for yourself, but do not give listings 
or copies of our software materials to others. Be aware that 
the contents of PC Disk Magazine are copyrighted private 
property. Your technical freedom to copy these materials im- 
plies no legal right to distribute them. We ask that you act re- 
sponsibly in your use of PC Disk Magazine and not abuse the 
spirit of free exchange. For our part, we will continue to make 
our material as useful to you as possible, with the expectation 
that, properly understood, this policy will best serve you our 
readers. 


ECHNICAL 
PREFACE 


To help our readers make the most of PC Disk Magazine, we 
would like to provide some background information concern- 
ing the editorial diskette, the accompanying manual, and how 
to use both. We don’t expect all of the following topics to be of 
interest to all our readers. Nevertheless we have preferred to 
err on the side of comprehensive support, rather than leave 
any of our readers confused or bewildered. So we encour- 
age everyone to at least skim this section to assure a solid 
background for the use of PC Disk Magazine. 


USAGE REQUIREMENTS 
PC Disk Magazine has been designed for use on an IBM Per- 
sonal Computer with a minimal set of hardware components: 
a keyboard, a monitor, and the PC itself with at least 64K of 
main memory. The display unit can be a monochrome dis- 
play adapter and monitor, or the color graphics display 
adapter with either a color monitor or an RF Modulator and 
TV set. The computer itself can be the PC or the PC-XT. 
These three pieces of equipment are all you need to run the 
majority of PC Disk Magazine software. Wherever possible 
we try to make the use of any other hardware optional. So, for 
example, many of the programs will generate printed output, 
but a printer is not required to use them. Occasionally howev- 
er, due to the nature of a program or its design, a particular 
piece of equipment will be necessary. There are two such 
programs in this issue: ‘‘Hide and Sink”’ requires a color dis- 
play unit, and the ‘“/BM Matrix Printer Control’ requires a 
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printer. When a program requires a piece of equipment not in 
the minimum configuration stated above, this component will 
be listed as a ‘Special Requirement” on the program’s title 
page in this manual. 

In regard to software, all PC Disk Magazine programs are 
designed to run under DOS 1.1 and DOS 2.0. Furthermore all 
BASIC programs in the magazine are designed to run under 
Microsoft’s Advanced BASIC. Neither DOS nor Advanced 
BASIC are provided on the PC Disk Magazine diskette; they 
must be acquired separately. As a rule these are the only out- 
side software elements you will need to use PC Disk Maga- 
zine. We will occasionally publish a program which uses 
some additional, publicly available software product, such as 
the “WordStar Configurator’’ in this issue. Any such addition- 
al software will be listed as a ‘‘Special Requirement’ on the 
program’s title page in this manual. 

A closing remark on this topic is not so much a requirment 
as a recommendation. We recommend that you make a copy 
of your PC Disk Magazine diskette to work with, and save the 
original as a backup. In some cases, such as the ‘‘Personal 
Cash Flow Manager’’ in this issue, you will have to make a 
copy of the program in order to use it. The reason is that some 
programs create additional files as they run, and these files 
must be stored on diskette as well. You may have noticed that 
your PC Disk Magazine diskette is write-protected. Thus it 
cannot receive these additional files. So a separate, working 
copy is needed. These situations will be explicitly mentioned 
in the manual. In general though, where the manual refers to 
“your PC Disk Magazine diskette’ you should read ‘‘your 
working copy of the PC Disk Magazine diskette.” 


THE IBM PC KEYBOARD 

In PC Disk Magazine we have tried to make our instructions 
as Clear as possible by the consistent use of special key sym- 
bols. In addition to all the common typewriter keys, which we 
print as they would appear when typed, the IBM PC keyboard 
has anumber of special keys. We have designed symbols for 
these keys, which are intended to resemble as much as pos- 
sible the keys themselves. Since these symbols are used ex- 
tensively throughout the instructions, we felt the following 
road map and glossary would help you, our reader, get any 
needed bearings. 


[ +s |THE FUNCTION KEYS 


There are ten special keys called function keys located at the 
far left of the keyboard. They are numbered from F1 to F10. 
This stands for Function One, Function Two etc. These keys 
are often used to make single keystroke choices or 
commands. 


[ «|THE ESCAPE KEY 


The ESC key is used most often for exactly what its name im- 
plies, to escape (exit) from various functions and processes. 


THE CONTROL KEY 


This key is always used in conjunction with another key by 
pressing this key and the other key simultaneously. The pur- 
poses of the Control key vary widely depending on the appli- 
cation program. 


THE TAB KEY 


This key is commonly used for horizontal tabbing in text files. 
It is sometimes used by programs to allow rapid cursor 
movement during full-screen data entry. 


[ — | THE BACKSPACE KEY 


The Backspace key is used to correct typing errors. By sim- 
ply pressing the key the preceeding character is erased and 
a new character can be entered. 


[ + |THE SHIFT KEY 
The Shift key is actually located on each side of the keyboard. 
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It is used in conjunction with other keys to capitalize letters, 
get special symbols like: ! @-# $ % % * () and other special 
functions. 


Caps 


THE PRINT SCREEN KEY 


This key is used with the Shift key to get a printout of exactly 
what is on the screen. In computer lingo this is called a 
screen dump, a dump of all the information on the screen to 
the printer. In PC Disk Magazine we also refer to this capabili- 
ty as ‘The IBM Print Screen Facility.” 


[ | THE ENTER KEY 


This is the most used key on the keyboard. Most every time 
you need to give information to the computer you have to 
press this key to ENTER that information. This key can also be 
thought of as the carriage return, since it works similarly to 
the RETURN key on a typewriter. 


THE NUM LOCK KEY 


Much like the Shift key, this key controls whether the numeric 
keypad will print numbers or act as cursor movement con- 
trols. You can tell that the NUM LOCK is on by pressing any of 
the number keys to see what is displayed on your screen. If it 
is the number, then the NUM LOCK is off. If it isn’t, then NUM 
LOCK is on. To change the setting press NUM LOCK once. 


THE CURSOR CONTROL KEYS 


These are the arrows that point up, down and to each side. 
The NUM LOCK has to be on for these keys to be functional. 
These keys control cursor movement within some PC DISK 


MAGAZINE programs. They will move the cursor in the direc- 
tion of the arrow. 


THE INSERT AND DELETE KEYS 


These keys really mean the INSERT and DELETE keys. And 
that is exactly how they are used. INS is used to insert new 
information and DEL is used to delete unwanted information. 
They are commonly used when editing BASIC programs, and 
can often be used when running BASIC programs as well. 


THE CAPS LOCK KEY 


This key is used to save you from having to hold the shift key 
down all the time to get capital letters. 


THE CONTROL AND SCROLL LOCK KEYS 


This key combination deserves special mention because of 
its importance in BASIC, the language of most PC DISK 
MAGAZINE software. These keys used together will interrupt 
the processing of any BASIC program. The keys should be 
used with caution because some interruptions can require 
you to start an entire procedure from the beginning. 


TERMINOLOGY 

In the preceding section we identified the special key sym- 
bols used in this manual, and gave a name to each one. For 
example: 


is called the Enter key. In our instructional narrative, it some- 
times makes more sense to refer to a special key by its name 
rather than its symbol. Thus the key names in the preceding 
section are also special terms for the purposes of this man- 
ual. Familiarize yourself with the names to facilitate your use 
of the manual, and refer to the preceding section as a glossa- 
ry of key names when necessary. 

In addition to the key names, a few other terms and 
phrases are used in this manual that may be unfamiliar to 
you. 

We commonly speak of putting a diskette in the ‘‘default 
drive.’’ This may seem like a needlessly vague phrase. After 
all, we know a diskette drive always has a one letter identifier 
associated with it, so why not refer explicitly to that letter? The 
problem with using an explicit letter reference is that it can 
create confusion about what exactly you must do. In other 
words, operationally it does not matter whether you put the 
diskette in the A Drive, the B Drive or even the C Drive (if you 
have a third diskette drive). What matters is that you put the 
diskette in the drive that is currently active, i.e. the drive 
whose letter prompt currently appears on the screen. This is 
your ‘‘default drive’’ because any disk command without a 
drive letter will look at the diskette in this active drive. So 
when you put a diskette in the ‘‘default drive,’ you can then 


PC DISK MAGAZINE 
11 


PC DISK MAGAZINE 
12 


issue commands referencing that diskette without the use of 
letter identifiers. 

Every start-up procedure for a BASIC program requires 
you to “‘Load Advanced BASIC into your PC.” To run a PC 
Disk Magazine BASIC program, the BASIC Interpreter must 
be up and running on your machine—you must be “‘in BA- 
SIC.” BASIC is really a program like any other. To start it you 
must load it from a disk into your PC and start it running. This 
is precisely what happens when you put your DOS diskette 
(or any diskette with the file BASICA.COM) in the default drive 
and type: 


BASICA 


By so doing you ‘‘Load Advanced BASIC into your PC.”’ 

When in BASIC, there are two kinds of commands: Direct 
and Indirect. Direct commands, like Load and Run, are exe- 
cuted immediately. Indirect commands are preceded by a 
line number; they are not to be executed at the time they are 
typed in, but when the program is run. You can assign a di- 
rect command to a function key, so that every time the func- 
tion key is pressed, that command is executed. The direct/ 
indirect distinction and its consequences give you some 
background for the ‘‘Basic Program Editor’ in this issue. 

One last bit of terminology. The ‘/BM Matrix Printer Con- 
trol’’ in this issue makes mention of ‘‘control codes,” such as 
a top-of-page code and a tab code. A control code can be 
thought of as a character just like a letter or a number, only 
rather than causing some character to appear, it causes an 
action of a different sort. It functions as a signal to a peripher- 
al piece of equipment, like a printer, causing that device to 
perform a specific action, like move the paper to the top of a 
new page. Control codes for the printer are the basis of the 
“IBM Matrix Printer Control.” 


TEXT CONVENTIONS 
Most of the textual conventions of this manual are fairly obvi- 
ous. The use of special key symbols has been covered. The 
use of special key names in the narrative text has been dis- 
cussed. That leaves two brief additional remarks concerning 
command lines. 

The lines set apart from the narrative text, in bold print and 
a different color, are commands that should be typed in ex- 
actly as they appear. When two key symbols appear immedi- 
ately next to each other in such a command line, they should 
be pressed simultaneously. For example: 


Scroll 
Lock 


means press the Shift key and the Print Screen key simulta- 
neously, thereby printing a copy of the current screen on your 


_printer. 


There is one exception to typing in command lines exactly 
as they appear. When a command includes a phrase such as 
““somename”’ or “‘programname”’ or “‘yourfile’’ you should 
replace that phrase (but not any punctuation) with a valid file 
name of your choice when you enter the command. 
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LOAN ANALYZER 
By Zyncon Inc. 


Special Requirements: None 
Files Used: LOANS.BAS 


Interest rates have just dropped. You’d like to know how this 
will affect the car loan you've just applied for and the monthly 
mortgage payments on the house you're negotiating to buy. 
And you don’t want to spend half the day doing the calcula- 
tions. You need LOAN ANALYZER. 

You supply LOAN ANALYZER with three of four key loan 
features—interest rate, amount borrowed, duration of the 
loan, or payment per period—and it will compute the value of 
the fourth. How would borrowing more or less affect your 
loan payments? How might increasing the length of your loan 
affect the amount you can borrow, given a certain maximum 
monthly payment you can make? How would different inter- 
est rates affect the answers to these questions? Ask LOAN 
ANALYZER. 
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Ona loan specification screen, you specify three of four fixed 
loan features and tell LOAN ANALYZER to calculate the miss- 
ing item. Once the computer has calculated the dependent 
loan item, you have the option to request a detailed payback 
schedule. LOAN ANALYZER will show you a period by peri- 
od schedule of your payments on a second screen, 12 peri- 
ods at a time. You can easily go back and change any loan 
parameter, and the computer will quickly recalculate. Both 
the specification and the payback schedule screens can be 
printed, and in addition you can have a complete detail 
payback schedule printed on your printer. 


CONCEPTUAL BACKGROUND 

The LOAN ANALYZER uses the ‘“‘add-on”’ method for install- 
ment loan calculations. Total interest over the life of the loan 
is computed, based on an unchanging principal balance. To- 
tal interest is then added to the amount borrowed, and that 
sum is divided by the number of payment periods, to obtain 
the payment per period. In the case of a balloon payment at 
the end of the loan, the total interest due remains the same, 
but the principal amount to be repaid is reduced by the 
amount of the balloon payment. 

In the detail payback schedule for an installment loan, the 
“payoff amount’ is computed using the Rule of 78’s. This 
widely used calculation method assigns a declining propor- 
tion of the total interest due on the loan to each payment peri- 
od. Thus, you pay back less principal in the beginning of your 
loan, since you are paying more interest. This is reflected in 
the “‘payoff amount.” 

There are instances where the Rule of 78’s cannot be ap- 
plied because the interest apportioned to the early periods 
actually exceeds the period payment itself. In these cases, 
the LOAN ANALYZER computes a simple linear repayment 
of the loan, whereby the same fixed amount of principal and 
interest are paid out in each period. Both the displayed and 
printed payback schedules will show the message ‘“‘(Linear 
Decline)’’ at the top of the payback table when this special sit- 
uation occurs. Be aware in this case that Cumulative Princi- 
pal, Cumulative Interest, and Payoff Amount are simple linear 
progressions. 

Mortgages are calculated using the traditional method of 
amortization. Interest in each payment period is computed on 
a declining principal balance. In the case of a final balloon 
payment, the balloon amount is treated like an add-on loan 
over the life of the mortgage; the difference between the prin- 
cipal amount and the balloon amountis amortized in the tradi- 
tional manner. 

One warning in connection with the LOAN ANALYZER. 
There are limitations to the accuracy of arithmetic calcula- 
tions in any computer language. The LOAN ANALYZER is 
written in BASIC, and BASIC offers good, but not deadly, 
arithmetic precision. Hence, you may notice some minor vari- 
ation in the results when specifying different parameters for 
the same loan. These are due to the limitations of BASIC, not 
errors in the implementation of LOAN ANALYZER. 


START-UP 
To start LOAN ANALYZER load Advanced BASIC into your 
PC by typing: 


BASICA 


Then put the PC Disk Magazine diskette into your default 
drive. Type: 


RUN“LOANS 


LOAN SPECIFICATION 

The first screen to appear is the loan specification screen. 
You enter values for the three loan features you want to set, 
and then instruct the computer to calculate the unentered 
item. 

You are first asked whether this is to be an installment loan 
or mortgage. Type | or M accordingly. At this point, the lower 
portion of your screen will display the loan parameters for 
you to enter, along with placeholding values for each param- 
eter. The rules for entry are not difficult. Enter all numbers 
with no commas and type in the decimal point if your entry is 
not an integer. Push: 


after every entry to go to the next parameter. To leave a pa- 
rameter value unchanged, type: 


when the blinking cursor is at the beginning of that parame- 
ter. To remove the value for a parameter (so that it becomes 
the item to be calculated), press the Space Bar once at the 
beginning of the entry field, then push: 


This action will blank out the item’s current value. Finally, to 
replace a value, simply type in the new value. As soon as you 
start typing, you will see the old value disappear. 

The key loan parameters have a number associated with 
them in the left-hand margin. To use the LOAN ANALYZER 
you must fill in three of these four parameters. The other two 
loan parameters, ‘‘Final Balloon Payment” and ‘‘Payment 
Frequency,’ must be assigned values in the specification 
process; they cannot be calculated by LOAN ANALYZER. 
They are included in this lower portion of the screen to make it 
easy for you to examine numerous loan scenarios. 

The specification process in LOAN ANALYZER is simply a 
matter of going through these six loan parameters in se- 
quence, entering a value for each (or leaving the value there 
unchanged), with the exception of the key loan parameter to 
be computed. The value for the key loan parameter to be 
computed must be blanked out (by using the Space Bar) or 
set to 0. If you enter an incorrect value for a parameter, you 
cannot go back up to correctit. You must finish going through 
the list of parameters and then cycle through again to make 
your change. Note well that to set the key parameter to be 
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computed, you must make that parameter’s value blank or 0, 
while entering valid settings for all the other parameters. 

“Amount to Borrow”’ can be any amount up to $10 million. 
Enter a final balloon payment only if the loan will not be repaid 
in full by fixed, even payments. For ‘‘Annual Interest Rate,”’ 
you can enter any two digit number with up to three decimal 
places. “Duration of Borrowing” should be any integral num- 
ber of years up to 99, and a number of months between 1 and 
12 separated by a comma. The “Payment Frequency” must 
always be entered. Acceptable values are M for monthly, Q 
for quarterly, and Y for yearly payments. Mis there by default. 
Finally, ‘‘Payment per Period”’ can be any dollar amount up to 
$1 million. 


LOAN ANOLYZER — SPOCIFICATION 


Installnent Loan or Mortgage : 


(1) finount to Borrow: $  75000.08 
Final Balloon Payment; $ 0.08 
Qnaual Interest Rate: 13.758 % 
Duration of Borrowing: 40,08 YY, 
Payment Frequency: MH (Monthig, Quarterly, Yearly) 
Pagnent per Period: $ 863.61 
Please fill in 3 of 4 key paraneters above. 
tailed ‘i k Schedule (Y/N)? _ 
te calculate, F2 to clear, F6 ts quit. 


¢ 


A completed Loan Specification screen. 


The LOAN ANALYZER does not validate your entries until 
you finish making the last entry, “‘Payment per Period.” After 
specifying this last parameter, you will see one of two mes- 
sages at the bottom of your screen. If your specification is 
fine, the message PARAMETERS OK will appear. Otherwise, 
there will be a message telling you which parameters are in 
error. In either case, you will see the cursor go to the far right 
side of your screen, opposite ‘Payment per Period,’ and 
stay there flashing under a faint W. 


CALCULATION 
LOAN | The LOANANALYZERis now in a wait state, awaiting instruc- 
ANALYZER | tion about what to do next. Your choices are simple. If you 
IS AWAITING | want the computer to calculate the missing parameter, and 


STRUCTION your specification is complete, push: 


WHAT TO DO 


NEXT. 
If you want to change or correct a parameter, push: 
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The cursor will return to the first parameter entry field so that 
you can cycle through the parameters again. If you want to 
start the specification process over from the beginning (for 
example, to examine another type of loan), push: 


and the LOAN ANALYZER will restart with its first question 
“Installment Loan or Mortgage.”’ To end execution of the pro- 
gram, push: 


These commands are only valid when LOAN ANALYZER is in 
the wait state. 


GETTING TO THE PAYBACK SCHEDULE 

When you request calculation for a valid loan specification, 
the computer will proceed to compute and then fill in the 
missing item. Your next choice is whether or not to display 
the payback schedule for a maximum of 60 payback periods, 
displayed 12 periods at a time. For monthly and quarterly 
payment frequencies with more than 60 payment periods, the 
LOAN ANALYZER will consolidate the period payments into 
annual totals. (It does not recalculate based on a yearly pay- 
ment frequency.) Hence, the duration of any loan must be 60 
years or less for a detail payback schedule to be displayed. If 
the loan is more than 60 years, calculation can still be done, 
but the LOAN ANALYZER will print a message at the bottom 
of your screen stating that a detail payback schedule cannot 
be displayed, and will return to the wait state for further in- 
structions. If payback schedule display is possible, a ques- 
tion appears at the bottom of the screen asking whether you 
want to see the display. Entering ‘‘N’’ for no sends the LOAN 
ANALYZER back to the wait state. Answering “‘Y”’ for yes 
leads you to the payback schedule screen. 


THE PAYBACK SCHEDULE 

The payback schedule display lists the loan parameters at 
the top of the screen. If the payment periods have been con- 
solidated to annual totals there will be a message after the pa- 
rameters stating that the periods represent annual consolida- 
tions. If the loan is an installment loan and the Rule of 78’s 
cannot be applied (see discussion above), a message ‘‘(Lin- 
ear Decline)”’ will appear as well. Then the 12 payment peri- 
ods will be displayed. For an installment loan, the columns 
will be “Cumulative Principal Paid,” ‘‘Cumulative Interest 
Paid,” and ‘‘Payoff Amount.’’ A mortgage will have the col- 
umns ‘Current Period Principal Paid,’’ Current Period Inter- 
est Paid,” ‘‘Cumulative Principal Paid,’ ‘Cumulative Interest 
Paid” and ‘“‘Unpaid Principal.” You can effectively scroll 
through the payback schedule 12 periods at a time. To do so, 


push: 
[=] 
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This will display the next 12 periods. To view the previous 12 
periods, push: 


Any screen may be printed using the IBM PC Print Screen Fa- 
cility, push: 


[4] 


In addition, a complete payback schedule, on a nonconsoli- 
dated basis, can be printed on your printer by pushing: 


Even if the screen display is consolidated, this printed sched- 
ule will not be so. 


-- MORTGAGE PAYBAI 


Bngagssseomemsssoe: 


Amount: 75000. a2 Armual Interest Rate: 13.75a % 
Final Balloon Payment: B Duration of Borrowing: 48,20 YY,MM 
Payment per Period: : Payment Frequency: Monthly 


Current Current Cumul. Cumul. Unpaid 
Principal Interest Principal Interest Principal 


859. 74996. 
1718. 74992. 
2578. 74388. 
3437. 74985. 
4296. 74981. 
S155. 74977. 
6014. 74973. 
6873. 74363. 
7732. 74365. 
8591. 74961. 
9452. 74957. 

12309. 74953. 
11168. 74943. 
12027.2 7494S. 


68386. 82 338955. 6613. 
69173.25 339031. Sa8e6. 
69969.50 339897. 
7774. BE 339155. 
71589. 46 339203. 
72413. 40 339242. 
73246. 77 339272. 
74989. 69 339292. 
7500. oo 329244. 


The comprehensive, detail payback schedule. 


You can return to the LOAN ANALYZER Specification screen 
at any time by pushing: 


Ei 


To exit the program, push: 


If you choose to return to the specification screen, the current 
loan specification will be redisplayed, and the LOAN ANA- 
LYZER will be in the wait state, allowing you to easily change 
a parameter. To go through the parameters again, push: 


To start a new specification, push: 


[a 


To return to the payback schedule, push: 


[s 
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AUTOMATIC BAR CHARTER 


By Mirror Images Software, Inc. 


Special Requirements: None. 
Files Used: AUTOBAR.BAS 


If you've ever wanted to turn a few dozen numbers into a bar 
chart, without cutting, pasting, or programming, AUTOMATIC 
BAR CHARTER is for you. With AUTOBAR you can produce a 
bar chart just as quickly as you can type in the data. 
AUTOBAR can handle up to 36 individual data values. You 
can plot single bars, or group your data in sets of up to four 
values each to produce clustered bar charts. The specifica- 
tions and data for a bar chart can be saved and reloaded. 
To set up your bar graph, enter your data, label it, type ina 
title for the graph and the scale, and hit the graph key. Use the 
computer’s scale increment or specify your own, and that's it 


—you have your bar chart. You can flip back to the screen | 


with your data and titles, make any desired changes, and ploi 
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again, all on one screen. You can print either your data 
screen or the bar chart at any time. 


START-UP 
To start the AUTOMATIC BAR CHARTER, load Advanced BA- 
SIC into your PC. Type: 


BASICA 


Then place your PC Disk Magazine diskette in the default 
drive and type: 


RUN“AUTOBAR 


First, you will be asked if you want to load an old graph. If you 
answer “Y”’ for yes, AUTOBAF will display a list of graphs on 
the default drive along the top of the screen, and prompt you 
in the lower right-hand corner of the screen for the name of 
the one you want to load. Answering ‘‘N”’ for no results in the 
program asking how many bars to a group you want for this 
new graph. Any response greater than one will create a clus- 
tered bar graph. 


DATA ENTRY 


TITLE OF Be a =) Western Region Sales #values -fi 
TITLE DESCR =) (Project - Actual) labels -f3 
SCALE DSP Hn =) Units (802) delete 


MIRROR IMAGES SOFTUARE, AUTOBAR (¢ 


A completed graph entry screen. 


For anew graph, you will see two column headings at the top 
of the screen: “Value” and ‘‘Label’’. Under Value will be six 
underscores. This is the prompt for the first data value. Enter 
a number up to six digits long (five with a decimal point). 
AUTOBAR will let you enter only numbers and a decimal point 
for the data fields. Trying to enter more characters than a field 
can hold results in the cursor looping back to the first position 
of the field, and you will start typing over what you initially en- 
tered. When you’ve entered the value you want, push: 


A group of underscores will now appear next to the data val- 


ue, under the Label heading. This is the prompt for the bar la- 
bel. Enter from three to six characters, as indicated by the 
number of underscores. (This number depends on the num- 
ber of bars to a data group.) When you've entered a label, 


push: 


and you will be prompted for the next number. When creating 
a clustered bar chart, you are prompted for the bar label only 
once per data group, with the first data value in a group. 

Proceed to enter your data values and bar labels in the 
manner described. To end this process, push: 


for the first data value in a group. The cursor will move to the 
bottom of the screen to prompt you for a graph title, then a 
graph subtitle, and finally, a label for the scale (the Y axis). 
With this information entered, your bar chart specification is 
complete. 

You are now presented with an activity menu in the lower 
right-hand corner of your screen. Make your choice by press- 
ing the appropriate function key. 


GRAPHING 


Western Region Sales 
(Project - Actual) 


A sample bar graph. 


The crux of AUTOBAR is F8, the graph function. Push: 


A question will appear on your screen concerning which 
scale to use for the graph. You can accept the computer’s 
suggested default, by pushing: 


Y [+] 


or you can specify your own value within the limits given. As 
soon as you reply, the graph will appear on your screen. You 


ZAKE 
YOU 


CHOICE BY 
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FUNCTION 
KEY. 
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can print the graph with the IBM PC Print Screen Facility. To 
do so, push: 


Lets 


Return to the specification screen by pressing any other key. 
On the specification screen, anything can be edited: F1 lets 
you edit the bar values; F3 lets you edit the bar labels; F5 lets 
you edit the titles. 


EDITING 
The editing process is the same in all three cases. When you 
choose to edit, two squares appear on either side of the first 
= =wo item in the category you want to change. These squares indi- 

SQUARES | Cate the value currently available for editing. Move these 

INDICATE | Squares with the vertical cursor control keys. Push: 

THE VALUE 
CURRENTLY ! 

AVAILABLE FOR | to move the squares down one entry. Push: 


EDITING. 


to move the squares up one entry. Move the squares until 
they are on either side of the value you want to change. If 
these cursor control keys do not work, push: 


Num 
Lock 


(The keys may not be in cursor control mode.) When the 
squares are opposite the desired value, push: 


[2] 


to open that value for editing. Now type in the new value you 
want. Use spaces to eliminate any trailing digits or letters. 
When the new entry is complete, push: 


If you choose not to make a change, just push: 


You're now ready for the next activity choice. 

F4 lets you delete values. The deletion process is the same 
as the editing of data values, except that it works on data 
groups rather than on individual data items. Position the 
squares to the first value in the data group to be deleted. (The 
squares will move from first group value to first group value, 
anyway.) Then push: 


and the values will be deleted. F6 lets you add values by sim- 
ply reactivating the underscore prompting after the current 
last data item in the list. Type in as many more values and as- 
sociated labels as you wish. To end the addition process, 


push: 
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on a blank data line for a group. You will then have a chance 
to change any of the three titles before returning to the activity 
menu. To leave a title line unchanged, push: 


FILING 
F7 and F9 are complementary activities that let you save and 
reload bar charts. To save the current bar chart, push: 


Following this keystroke, the activity menu will disappear and 
a prompt for the filename under which you wish to save your 
graph will appear in its place. If you enter a filename already 
in use, you will be told so, and given the option to replace it or 
use another filename. When the file has been saved, the ac- 
tivity menu will reappear along with your current graph data. 
The specification for the graph (including the data) will be 
saved, but not the graph itself. Thus, when you select F9, and 
choose which bar chart to load, you are presented with the 
complete table of data and titles for that graph. To regenerate 
the graph itself, push: 


Loading a pre-existing bar chart will wipe out whatever graph 
you were just working on, so save your current graph before 
loading a new one. 

To end AUTOBAR, push: 


F10 


This will end execution and leave you in BASIC. One small 
warning with AUTOBAR: Because of the way BASIC cleans 
up variable storage while executing, AUTOBAR may start to 
behave strangely if run for more than one continuous hour. 
Should this happen, end the program, leave BASIC, return to 
BASIC, and restart AUTOBAR. 


— 
CALLING ALL PROGRAMMERS!! 


If you have written software for the IBM PC that you feel would 
be of use or interest to others, PC Disk Magazine would like to 
know about it. Publishing is no longer just for poets and pro- 
saists, but now it’s for programmers too. Ask for our Software 
Submission Plan by writing to: 

PC Disk Magazine 

Dept. 732 

One Park Avenue 

New York, N.Y. 10016 
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XPANDING 
THE CODE 


When you list any of the BASIC programs on your PC Disk 
Magazine, you will find that the code is often quite dense, and 
there is a conspicuous scarcity of comments. This does not 
represent the latest standard in BASIC coding. We would 
have loved to space the code out in an eye-catching fashion, 
and document it thoroughly with comments. 

Unfortunately, the line numbers and comments take up 
storage space, and storage space is a precious resource to 
us and our readers at PC Disk Magazine. So we were forced 
to economize on space in order to maximize our product of- 
fering. To unravel the BASIC code, we suggest that you put it 
in a form that you can edit with some system editor (EDLIN or 
WordStar, for example) and then expand the spacing. To do 
this, you must convert the program from the form itis in on the 
PC Disk Magazine diskette to a standard ASCII file, which an 
editor can manipulate. The procedure for performing this 
conversion is to load the program from the PC Disk Magazine 
diskette into BASIC, and then save it with the A option, to save 
it as an ASCIl file, onto another diskette. Specifically, first 
load advanced BASIC by typing: 


BASICA 


then put the PC Disk Magazine diskette in the default drive. 


Type: 
LOAD “programname 


where “‘programname”’ is the name of a BASIC program on 
the PC Disk Magazine diskette. Lastly, replace the PC Disk 
Magazine diskette with a work diskette and type: 


SAVE “‘programname”’, A 


An ASCII version of the program will now be written on this 
work diskette. You can then exit BASIC and call this program 
file into an editor. Use the editor to start a new line at every 
colon in the file. This will make the code much easier to read 
and the logic, thereby, more apparent. 
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OJRDSTAR Program, Release 3.2X 


Files Used: \ 


— 


t WORDSTAR, all of the editing features 
ir original ‘‘factory settings.”’ This forces 
you to go throug@fa start-up ritual of resetting various features 
to the values You want. The WORDSTAR CONFIGURATOR 
lets you make permanent changes to the initial feature set- 
tings so that WORDSTAR will come up the way you want it, 
ready to run. With the WORDSTAR CONFIGURATOR you can 
even make several copies of WORDSTAR with different initial 
settings, each copy appropriate to particular text processing 
activity. Of course, you can still change your initial feature 


STAR (e.g., WS.COM) 


Every time 
are initializeavto 
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settings during your WORDSTAR session if you choose. 

The original WORDSTAR program design includes an in- 

ternal table of values, which represent the current settings for 
each of the editing features. The WORDSTAR CONFIGURA- 
TOR works by making permanent changes to the initial val- 
ues in this table. Editing features are grouped into categories, 
and for each category there is a single screen with the menu 
of features you can change. With the use of ten function keys, 
you select a feature, specify a value, and go from one menu 
to another. The feature menus always show you the current 
values of all features displayed. 
The WORDSTAR CONFIGURATOR is designed to be used 
only with WORDSTAR releases in the 3.2 series. WORD- 
STAR version 3.3 has its own configuration facility, so you do 
not need the WORDSTAR CONFIGURATOR for it. Versions 
earlier than the 3.2 series used a different internal table de- 
sign, so the WORDSTAR CONFIGURATOR cannot modify 
them. The WORDSTAR CONFIGURATOR can identify inap- 
propriate versions of WORDSTAR automatically and will 
refuse to alter them. 


START-UP 
To run the WORDSTAR CONFIGURATOR you must first load 
Advanced BASIC into your PC. Type: 


BASICA 


Next, put your PC Disk Magazine diskette in the default drive. 
Start the WORDSTAR CONFIGURATOR by typing: 


RUN “WSCONFIG 


The ‘‘Main Menu” a diagram of the ten function keys with ac- 
companying selection labels, will appear on the screen. This 
same function key menu format is used consistently through- 
out the WORDSTAR CONFIGURATOR. The menus for differ- 
ent groups of editing features simply have a different menu ti- 
tle and different labels for the function keys. The bottom half 
of the screen contains a message box, where prompts, in- 
structions and responses will appear. Initially this message 
box beneath the Main Menu will ask you to start the program 
by pressing: 


MULTIPLE WORDSTARS 
You are next asked to specify the name of the WORDSTAR 
file you intend to configure, and its disk drive location. The 
standard WORDSTAR file that you receive when you pur- 
chase WORDSTAR is WS.COM. That’s why this filename is 
the assumed name, and you can simply press the Enter key 
to select this name. 

There are occasions, however, when you may choose to 


rename the WS.COM file. For instance, you might want to 
create two copies of WORDSTAR, choosing the file name 
WSDOC. COM for use with document files and 
WSNON.COM for use with non-document files (e.g., pro- 
grams). With this arrangement you would invoke WORD- 
STAR with the command WSDOC or WSNON as appropri- 
ate, rather than the usual WS. You can customize the 
versions with different settings, but both will still be on the 
same disk and share the same WORDSTAR overlay files. If 
you choose to rename your WORDSTAR file, you must make 
a copy of the WS.COM file with the new name before starting 
the WORDSTAR CONFIGURATOR. For example, by execut- 
ing the command 


COPY WS.COM WSDOC.COM [<] 


before starting the Wordstar CONFIGURATOR, you could 
now reply with a filename of 


WSDOC 


to configure your version of WORDSTAR for editing 
documents. 

Once you've entered the file name, you'll be asked for the 
drive with the WORDSTAR file. Enter the correct letter. Load 
the disk with the WORDSTAR file in the appropriate drive. 
Then push any key. A message will appear that the file is be- 
ing opened, followed by a request to choose any function key 
in the Main Menu. 


GENERAL PROCEDURE 


The Main Menu. 


Changing any of the feature settings is a straightforward pro- 
cess. In the Main Menu all the editing feature categories are 
listed. Following the selection of a category, a submenu will 
appear on the screen. Once you've selected a submenu, you 
may then choose to change the status of any or all of the list- 


= =HERE 
ARE 
OCCASIONS 
WHEN 

YOU MAY 
CHOOSE TO 
RENAME 

THE WS.COM 
FILE. 


PC DISK MAGAZINE 
27 


2 2HEN 
THE EDITING 
SUBMENU 

APPEARS, 
YOU’LL FIND 
THE FUNCTION 
KEYS HAVE 
NEW FEATURES 
ASSIGNED 

TO THEM. 


PC DISK MAGAZINE 


ed WORDSTAR editing features. 

Each feature in a submenu has a function key associated 
with it. For features with a status of ON or OFF the associated 
function key will switch the setting to the opposite status. For 
features allowing more than two setting values or choices, 
hitting the associated function key will cause the computer to 
cycle through those values or choices. For example, if the 
value setting is a number from 1 to 10, each stroke of the 
function key will increase the setting value by 1. Once you 
reach 10, the computer will cycle back to 1. When you com- 
plete all of the setting changes desired within a submenu, 


push: 


to return to the Main Menu (The only exception is the setting 
of function keys, discussed below.) You can now go on to an- 
other submenu, or begin the exit procedures. 


SETTING AN ‘‘ON/OFF’’ FEATURE 

With the Main Menu on your screen and your copy of WORD- 
STAR in the appropriate drive, you’re ready to begin the con- 
figuration process. Let's try turning off right margin justifica- 
tion. You'll find that setting listed under ‘Editing Settings.” 


Push: 
[=] 


When the editing submenu appears, the label associated 
with the F1 function key should read ‘‘(ON) Justify Margins.” 
Since this is an ON/OFF editing feature, pushing: 


[*] 


will change the value of the ‘‘Justify Margins’’ feature to 
(OFF). Pushing: 


again will restore the value of this feature to (ON). 


SETTING A ‘‘VALUE’’ FEATURE 


If you want to change the current left margin setting, push: 


With each stroke of the F3 function key, the number to the left 
of the function title will change. When the number reaches the 
highest valid setting for the parameter, it cycles back to the 
minimum value. 

The same method of setting feature values is used for all of 
the submenus except for the Monochrome/Color settings 
and the Function Key Settings. 


HELP 

There is a HELP feature available on every menu with the sole 
exception of the menu for function key settings (for this menu 
the help messages are on permanent display in the message 
box, located in the lower portion of the screen). You access 
the HELP feature the same way in all menus. First, press: 


to invoke the HELP feature. The message box now instructs 
you to press any other function key to display additional infor- 
mation about the feature or feature category associated with 
that function key. For example, if you're at the Main Menu and 
want to know more about the feature category ‘'Print-time 
Settings,” press: 


followed by 


(e| 


Alternatively if you’re at the Print-time settings sub-menu, and 
want to know more about the ‘‘Page Offset’’ feature, press: 


followed by 


Once you've invoked the HELP feature with F9, you can con- 
tinue pressing other function keys, one after another, to ob- 
tain additional information about each associated feature or 
feature category. To leave HELP mode, simply press: 


[«] 


COLOR/MONO SETTINGS 


The Color/Mono Submenu—sample display requested. 


To modify the monochrome or color display patterns used by 
WORDSTAR you must start at the Main Menu. From there, 


push: 
[e] 
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By default, you will be ready to alter the settings for whichever 
mode, monochrome or color, you have been working in. 
Note that the monochrome and color display settings are 
separate and independent. The WORDSTAR CONFIGURA- 
TOR lets you set each separately by allowing you to switch 
from the selection of monochrome display features to the se- 
lection of color display features and vice versa. The way to 
switch between the two is displayed on the submenu. To 
switch to the selection of monochrome features, push: 


To switch to color feature selection, push: 


In order to switch between monochrome and color display 
specification, you must have both adapters and both moni- 
tors in your hardware setup. Monochrome features can only 
be set on a monochrome monitor; color features only on a 
color monitor. 

If you mistakenly command a switch to occur when there is 
no monitor, just hit the relevant switch key (F1 or F2) to return 
to the active monitor. 

The submenu for Color/Monochrome settings allows you 
to choose text display, block text display, and the back- 
ground display for each. At the bottom of the submenu 
screen the ‘‘Current text attributes’’ and ‘‘Current block 
attributes”’ are on display, in those very words. During the se- 
lection process these lines display the current display 
settings. 

Selecting the display pattern is done much like the selec- 
tion for a multi-value feature on other submenus. In mono- 
chrome display, text can be displayed as normal, high inten- 
sity, reverse video, or underlined. In the selection process 
you cycle through these choices, for normal and block text, 
by repeatedly pressing the F3 key or F5 key respectively. In 
monochrome mode, pressing the keys for background se- 
lection has the same effect as ‘‘foreground”’ selection. 

With a color display, the foreground/background distinc- 
tion is meaningful, so four different settings can be made 
(normal text foreground and background, block text fore- 
ground and background). 

You can display the current monochrome or color settings 
at any time while in the Color/Monochrome Menu by 
pressing: 


The message box will present a sample of text. Press any key 
to continue. 


FUNCTION KEY SETTINGS 
The setting of function keys allows you to associate one of 18 
different WORDSTAR commands with each function key. For 


example, you can configure WORDSTAR so that any time 
you press function key F8 while in WORDSTAR, the cursor 
will move to the end of the file. In this way the function keys 
become powerful shorthand commands. 

In the Function Key Submenu, the WORDSTAR command 
currently available for assignment is displayed below the 
message box, at the bottom of your screen. The message 
box explains that you must press the Space Bar to cycle 
through the 18 WORDSTAR commands available for assign- 
ment. Each time you press the Space Bar, a new command 
appears at the bottom of your screen. When you see a 
WORDSTAR command you would like to assign to a function 
key, simply press the appropriate function key while that 
commandis on display. That WORDSTAR command will then 
appear on the submenu next to the function key you've just 
pressed. The assignment is made. 

There is no HELP feature here since function key F9 has to 
be available for command assignment like the others. Simi- 
larly, function key F10 is not used to return to the Main Menu. 
When you finish assigning WORDSTAR commands to func- 
tion keys, press: 


is 


to return to the Main Menu. 


SAVING THE CONFIGURATION 

AND EXITING 

When you're finished entering all your configuration settings, 
you must return to the Main Menu to save these new settings. 
Once there, push: 


The prompt will ask you whether or not you want to continue 
with the save procedure. If you wish to continue, push: 


The changes will be saved, and you'll be returned to the Main 
Menu. If you decide to cancel the saving operation, hit any 
other key and you'll be returned to the Main Menu. If you 
complete the save procedure, the new version of WORD- 
STAR will be written on the disk. If you choose to quit, none of 
your new settings will be installed. 

Once you've saved your changes, or if you simply want to 
exit the WORDSTAR CONFIGURATOR, push: 


If you haven't saved your new Settings, the prompt will ask 
you to confirm that you do not want them saved. To exit, push: 


If you decide not to exit, push any other key. When you exit, 
you will be left in Advanced BASIC. 

Before putting your new WORDSTAR to use, you should 
test it thoroughly, paying special attention to the performance 
of the settings you've just modified. 
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= === ROBLEM RECOVERY 


There really is nota great deal to say about problem recovery 
with PC Disk Magazine. lf you use this software on the right 
equipment running the appropriate system software, as out- 
lined in the Technical Preface, you should experience no 
problems. Nevertheless, a few comments may resolve some 
more obvious difficulties. 

Any BASIC program can be interrupted at any time by 
pressing: 


Scroll 


If you do not see the OK message immediately, indicating that 
you are back in BASIC, press these keys again. This is a rath- 
er drastic but effective way of regaining control of the com- 
puter. You won’t damage any of the programs in this way, 
since they’re still intact on the diskette. However, you will lose 
any data you entered while the program was running. 

If you interrupt a program you may find that the function 
keys no longer perform as they had before starting the pro- 
gram. This is because many PC Disk Magazine programs re- 
set the function keys during execution, then restore the 
original settings upon completion. An interrupt causes an ab- 
normal termination of a program, so the function keys are not 
restored. To correct this situation, simply exit from BASIC and 
then return to BASIC. 

You may find at times that the cursor control keys are not 
working as they should. This is because the keys are not in 
cursor control mode. The key that switches these keys be- 
tween numeric mode and cursor control mode is the Num 
Lock key. So to restore the keys to cursor control mode 
press: 

Num 

Lock 
If you try to send something to the printer when there is no 
printer, or when the printer is off or offline, you will hang the 
system. The computer will just sit there and will not respond 
to any keys pressed. After a few seconds you may get a BA- 
SIC error message indicating that the device was unavail- 
able. The program that was running has been aborted, and 
you will be left in BASIC. If the computer does not put out any 
message, but just remains hung, you will have to say good- 
bye to whatever you were doing and re-boot your system. 

Though we hope you will never need it, if you should find a 
“bug” in a PC Disk Magazine program, the address to write 
to is: 

PC Disk Magazine 

Dept. 741 

One Park Avenue 

New York, N.Y. 10016 
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BASIC PROGRAM EDITOR 


By Richard V. Smith 


Special Requirements: None 
Files Used: BPE.BAS 


When writing a program in BASIC, you’ve no doubt run into 
situations where you've come up with a new idea to add to 
what you've already written. Or you would like to go back and 
correct errors, eliminate the “‘bugs’’ and review some portion 
of the program. But, as you well know, the longer the pro- 
gram, the more difficult it is to find the part of the program you 
want. The BASIC PROGRAM EDITOR (BPE) helps you rapidly 
find your way through your program and allows you both to 
edit and test the program along the way. 

BPE has two modes of operation, EDIT mode and ACTION 
mode. In ACTION mode you can run programs, save pro- 
grams, list files, kill files, turn program tracing on and off, all at 
the touch of a function key. EDIT mode works by breaking 
your program down into a series of ‘‘pages’’ approximately 
20 lines each. The function keys in turn are assigned com- 
mands that let you get around your BASIC program with a 
single keystroke. You can cause the first page or the last 
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page or your program to be displayed. Or you can ask for the 
page that contains some specific line number of interest to 
you. BPE lets you switch back and forth between ACTION 
and EDIT modes at the touch of a key. 


BACKGROUND 

BPE is actually itself a BASIC program which occupies lines 0 
to 99. It works by dynamically assigning different Direct BA- 
SIC commands to the different function keys. Thus when you 
press a function key you cause the associated command to 
be executed. This approach is just like the essential design of 
IBM’s BASIC, wherein the function keys have, by default, a 
set of commands associated with them when you start BA- 
SIC. BPE expands and lends flexibility to this built-in com- 
mand shorthand by varying, in a systematic and useful way, 
the command associated with each function key. 

From a practical standpoint you need only be concerned 
with what each function key does in EDIT mode and ACTION 
mode. However, understanding that BPE is a BASIC pro- 
gram, which runs as you use it on your own program, clarifies 
some aspects of its use. For example, BPE is resident in BA- 
SIC at the same time as the program you are editing. Since 
BPE occupies line 0 to 99, any program to be edited must be- 
gin at line 100. Why 100? Because to run the program being 
edited, BPE does an automatic GOTO line 100. Hence, there 
must be a line # 100. Additionally, the function keys can only 
be assigned commands up to a certain length. Therefore, 
BPE cannot work on programs with line numbers of more 
than 4 digits. 

Other consequences of BPE’s design will be explained in 
the following usage instructions. Let’s start it up and explore 
what it can do. 


START-UP 
Load Advanced BASIC into your PC by typing: 


BASICA 


There are three different ways to initiate the use of BPE, de- 
pending upon the status of the program you intend to use it 
with. 

If you want to create a new program and have BPE avail- 
able for editing, put the PC Disk Magazine diskette in the de- 
fault drive and type: 


MERGE “BPE 


RUN 1[ 4] 


(Remember to begin entering your program with line # 100.) 

If you want to work further on a program that you previously 
saved with BPE as part of it, put the diskette with that program 
in the default drive and type: 


LOAD “programname 


RUN 1 [1] 


The third case is when you want to use BPE on a program 


you've previously created. This will be the most common cir- 
cumstance when you first start using BPE. What you need to 
do is merge BPE into the currently existing program. Put the 
diskette containing the program to be edited in the default 
drive and type: 


LOAD “programname 
RENUM 100 


This program is now in memory, and starts on line 100, Re- 
place this program diskette with your PC Disk Magazine 
diskette and type: 


MERGE “BPE 


RUN 1[ <] 


In all three cases the last command initiates execution of 
BPE. You begin in EDIT mode, as indicated by the first word 
on the bottom line of your screen. Following the mode indica- 
tor are the values for each of the function keys. 


EDIT MODE 


CATE 15, B:PRINT “Fora F Teed Defeat?" 


10 
Lou 15,47 TPRINT “Lines / EN) 
OCATE 16, S:PRINT STRINGS 16 


Ea 14 
g? ta cer control ee 
ny tT 


nr SEE CORE SSE A SE CR OT SO 1 


A split screen display—two separate program sections. 


Some brief background on EDIT mode will provide the con- 
text for explaining these keys. 

As stated in the introduction, EDIT mode breaks up your 
program into pages of approximately 20 lines each (the aver- 
age number of BASIC program lines that will fit on a single 
screen). You work in EDIT mode by first locating a page, and 
then displaying it. The act of locating a page does not auto- 
matically cause the page to be displayed. Rather, it sets the 
display function to that page. The display function, when in- 
voked, lists the currently located page on the screen. Thus, 
there are several EDIT mode keys for locating pages, which 
set the current page for the display keys. 


WORK IN EDIT 
MODE BY 

FIRST LOCATING 
A PAGE, 

AND THEN 
DISPLAYING IT. 
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Keys and their meanings are as follows: 


[» JactN 


Switches to ACTION mode. 


[e| HALF 


Splits the screen to allow two separate half pages to be dis- 
played simultaneously. Changes function keys F3 to F6 to 
control display for one half page, F7 to F10 to control dis- 
play for the other half page. The bottom of the screen will 
be labeled ED/t whenever the half page edit commands 
are in effect. When in half page edit mode, pressing func- 
tion key F2 restores full page edit mode. 


[= Jany 


Prompts you to enter any line number for display, then sets 
the LIST (F6) command to display the page containing that 
line when pressed. 


[  JuP 


Sets the LIST (F6) command to display the page preceding 
the current page when pressed (i.e. the page one closer to 
the beginning of the program). 


DOWN 


Reverse of F4. 


[ & |uist 


Displays the page of lines currently located. 


TOP 


Sets the LIST (F6) command to display the first page of the 
program when pressed. 


[  |RENUM 


Renumbers the program beginning with line 100 (so BPE is 
not renumbered as well) in increments of 10. 


BOTM 


Locates the last page of your program and sets the LIST 
(F6) command to display that page when pressed. 


[ro] List+ 


Like F6, displays a page of lines from the program, but offset 
half a page from the currently located page. This key is partic- 
ularly helpful when the lines you want to see are partly on the 
page displayed by LIST (F6) and partly on the next page. 


In brief, function keys F3, F4, F5, F7, and F9 perform page 
locating functions, while F6 and F10 perform display func- 
tions. In practice you will quickly develop the reflex of press- 
ing F6 or F10 immediately after a locate function to display 
what has been found. 

With BPE, all of BASIC’s standard, full-screen editing facili- 
ties are available for detail editing. So when you have a page 
of program lines on your screen to modify, use all the familiar 


cursor control, insert, delete and other BASIC editing capa- 
bilities as usual. 


EDIT POINTERS 

Three brief comments should expedite your use of BPE’s 
EDIT mode. First, some editing functions, F8 and F9, occur in 
two steps. You must press the same key a second time, when 
you are told to do so, in order to complete the operation. 

Second, the ‘‘bottom’’ function, F9, works by scrolling 
through your entire program, beginning with the last line of 
the current page, until the end of the program is reached. If 
you’re near the top of a long program, this can take a while. 
Therefore before you do a ‘“‘locate bottom’, do a ‘“‘locate 
any” of a line number you know to be near the end of your 
program. A following ‘‘locate bottom’”’ function will then get to 
the bottom much faster. 

The third comment concerns BPE’s display page length of 
20 lines. If your BASIC program lines span more than one 
screen display line, you may find that the first lines of a BPE 
page scroll off the top of your screen when the page is dis- 
played. You can correct this by making a change to BPE 
itself. 

In lines 1 to 9 of BPE, all the parameters used in BPE EDIT 
mode are established. The first part of a typical line appears 
as follows: 


VIEW.% = 1: BEGIN. % = 100: INCR.% = 10: 
PSIZE.% =20: 


The variable PSIZE.% sets the page size in number of pro- 
gram lines. BPE program line #1 sets this parameter for full- 
page display; line #4 sets it for half-page display, invoked 
with F6; and line #7 sets it for half-page display, invoked with 
F10. Therefore to adjust the lines per page, in both full and 
half-page display, edit lines 1, 4, and 7, and reduce the value 
assigned to PSIZE.%. 

(Programmer's Note: three parameter lines fully define a 
run-time version of BPE. BPE has three built-in versions. 
Lines 1, 4, and 7 define one set of parameters, activated with 
the command RUN 1. Lines 2, 5 and 8 are another, activated 
with RUN 2. Lastly, lines 3, 6, and 9 are a third, activated with 
RUN 3. Other parameters in these lines you can change are 
BEGIN.% (starting line number of user program) and 
INCR.% (line number increment). These two variables 
should have the same setting in all three associated parame- 
ter lines. Thus you have three different versions of BPE avail- 
able simultaneously with different RUN startup commands.) 


ACTION MODE 

The ACTION mode function key commands are, for the most 
part, the standard BASIC assignments. And they operate just 
as they do in standard BASIC. One group of keys is useful for 
working with your files: 


F3 (LOAD), F4 (SAVE), F8 (KILL), F9 (FILES), F10 (MERGE). 
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Note that the use of F3 (LOAD) will wipe out whatever is cur- 
rently in BASIC, including BPE. 

The other group of ACTION mode keys are useful when 
you are testing changes you have made to your program: 


F2 (RUN), F5 (CONT), F6 (PRINT), F7 (TRACE). 


These keys also function as they do in standard BASIC. 
Hence you would invoke execution of the program being 
edited by pressing: 


[| 


The program will run as if BPE were not there at all. When the 
program completes, or if you break its execution, you can re- 
start BPE with the command. 


RUN 1 [ 1] 


You may have noted that ACTION key F7 (TRACE) is not in 
fact a standard BASIC command. In BPE ACTION mode, this 
key lets you change the commands associated with function 
keys F7, F8 and F10. When you first press F7, the ‘‘trace on’’ 
(TRON) command becomes associated with F7, and ‘‘trace 
off’ (TROFF) with F8. This puts program tracing at your dis- 
posal. In addition F10 becomes DELET. This is not a BASIC 
command. Rather, it allows you to delete BPE from your BA- 
SIC work area before saving your program. We will discuss 
this further in a moment. These keys, F7, F8 and F10, are re- 
stored to their original values every time you enter ACTION 
mode. Hence to restore them after being changed, just press 
F1 twice (once to go to EDIT mode, again to re-enter ACTION 
mode.) 


EXITING 


Once you've finished editing, you may save your program 
with or without BPE. If you want to save a little space on your 
diskette you can eliminate BPE before saving your program. 
Most likely you will do this only when you are not expecting to 
edit your program any further. First enter ACTION mode and 


press: 


Then press: 


When you get the message ‘‘Delete BPE?” answer with a 
“Y". Ayes answer will delete lines 0 to 99, returning the func- 
tion keys to the standard settings as given in your BASIC 
manual. To save your file, type: 


SAVE “yourfile 


The advantage of saving BPE with your program is that it is 
then immediately available for use the next time you load your 
program into BASIC—no merging is necessary. To save your 
program with BPE, all you need to do while in BPE is type: 


SAVE “yourfile 


ROGRAMMING 
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THE PERPETUAL CALENDAR 
By Morris Effron 


Special Requirements: None (printer optional). 
Files Used: PERPCAL.BAS. 


What day of the week were you born? How many days have 
you been alive? What was the calendar for the month you 
were born? You don’t know? Use THE PERPETUAL CALEN- 
DAR to find out. 

With THE PERPETUAL CALENDAR you can find the day of 
the week for any date from January 1, 1800 to December 31, 
2800; you can determine the number of days between any 
two dates in this time range; and you can print the calendar 
for any month within these years. You simply select which of 
these three items you want to know, type in the relevant 
date(s), and you have the results immediately. 

In case you don’t have unbounded interest in the calendri- 
cal details of your life or those of others, THE PERPETUAL 
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CALENDAR offers more. It has been programmed so that you 
can extract the ‘date validation” and “elapsed days’ sub- 
routines and include them in programs of your own. Thus, 
any time you have a programming need for processing 
based on the day of the week, or days between two dates, 
don't re-invent the wheel—use THE PERPETUAL 
CALENDAR. 


START-UP 
To start THE PERPETUAL CALENDAR, first load Advanced 
BASIC into your PC by typing: 


BASICA 


Then put the PC Disk Magazine diskette in the default drive 
and type: 


RUN “PERPCAL 


You are now presented with the three-item menu of activities 
for THE PERPETUAL CALENDAR. Type in the number of the 
activity you would like to perform. (You need only press the 
number itself; the Enter key is not needed.) 


ENTERING DATES 

Each of the activities will first ask you for a date. For the com- 
putation of weekday or elapsed days, dates should be en- 
tered in the form Month # /Day # /4-Digit Year. For example, 
May 16, 1865 should be entered as 


5/16/1865 | |] 


(Don’t forget to type in the slashes.) For the date of a calen- 
dar, the day of the month is not necessary, so the date format 
is abbreviated to Month # /4-Digit Year. You will be asked to 
enter two dates for the elapsed days activity. You can enter 
the dates in any order. The computer will determine which is 
the earlier and which the later. Only one date is necessary for 
the other two activities. 


EXECUTION 

Once you supply the dates, the computer spins the Great 
Mandala and gives you an answer immediately. If you have 
chosen to print a calendar, the computer pauses until you 
press a key to indicate that printing should begin. When the 
activity is completed, and the result printed or displayed, you 
are asked to press any key to continue. Pressing a key 
causes you to return to the first prompt for the activity you are 
in, allowing you to repeat the activity for different dates. For 
example, you select the ‘‘Weekday of Any Date”’ activity and 
enter 12/7/1941. The computer tells you that December 7, 
1941 was a Sunday, and prompts you to continue by press- 
ing any key. When you do so, you are returned to the prompt 
for the date. You can now enter another date for which you 
wish to know the day of the week. 


4. NUMBER OF DAYS BETWEEN TW DATES. 
2, WEEKDAY OF ANY DATE. 
3. CALENDAR FOR ANY MONTH. 
4. EXIT 
ENTER CHOICE: 1 


FIRST DATE C(MYVDD/YYYY): 4/4/1908 


SECOND DATE (PEVDD/YYYY); 9/471993 


NUMBER OF DAYS BETUEEN THESE DATES 15: 30,558 
(PRESS ANY KEY TO CONTINUE) 


Sample execution—the number of days between two dates. 


When you want to exit from an activity, press: 


by itself as the response to the first prompt within an activity. 
This initial ‘‘null’’ response will send you back to the Main 
Menu so you can select another activity. If you make a mis- 
take in your selection of an activity, just press: 


in response to the activity’s first question to return to the Main 
Menu and reselect. Choice four on the Main Menu allows you 
to exit from the program and leaves you in BASIC. 


THE SUBROUTINES 

The two key subroutines of THE PERPETUAL CALENDAR are 
the ‘‘date validator’ and the ‘‘elapsed days calculator.” The 
former is lines 9100-9190. The latter is lines 9200-9340. 

The date validator takes the character string in the variable 
ADATES$, and verifies that it is in the form MM/DD/YYYY. It 
uses the flag OKD to let the main program know if the date is 
valid (if OKD is 0 the date is no good, otherwise it’s okay). In 
the process of date validation, three integer variables D,M, 
and Y, are assigned the numeric day, month, and year por- 
tions, respectively, of the string ADATES. In addition the vari- 
able LP is set to true if the year of this date is a leap year, oth- 
erwise it’s set to false. 

The “elapsed days calculator’ uses dates that have al- 
ready been broken into their numeric day, month, and year 
components by the date validator. The components for one 
date are in the variables D1, M1, and Y1; for the other date 
D2, M2, and Y2 are used. The elapsed days calculator be- 
gins by determining which is the earlier date, and then com- 
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putes the number of days from the earlier to the later date and 
puts this result in the single precision variable TDS. 

Both subroutines make use of the array DS, which is a 12- 
element array containing the number of days in each month 
of the year. The need for this information to verify dates and 
compute elapsed days is obvious. In addition, the elapsed 
days calculator makes use of a 7 element array NLP, which 
contains a list of centenary years that are not leap years. This 
list is needed to adjust the total elapsed days downward if 
any of these years lie between the two end dates in question. 
This is not an exhaustive list.of such years; it contains only 
those that fall between 1800 and 2800. Both these reference 
arrays, DS and NLP, are dimensioned and filled in the initial- 
ization subroutine, lines 1000-1030. Hence, you should copy 
this initialization section into your program when using either 
the date validator or elapsed days calculator in your own 
application. 


TANUARY 2OOO 
faiak oP Soe 
SUNDAY MONDAY TUESDAY WEDNESDAY] THURSDAY FRIDAY SATURDAY 
a +—— 
bh oe we at! 
2 * 4 : é& 7 8 
2 10 i1 12 eh 1 2 14 15 
a bos ost 
16 17 18 19 20 21 22 
+ 
23/30 24/31 25 26 Pf 28 27 
— 
Sample calendar—start the century right. 


If you prefer to be spared Rod Serling's introduction to the 
program every time you run it, just halt execution, enter one 
line, save the result, and then restart. The sequence to key is 
as follows: 


9001 RETURN 
SAVE “PERPCAL 


RUN 


PERSONAL | 
CASH FLOW 


MANAGER 
By Gary Oppenheimer 


Special Requirements: None 

Files Used: CASH.BAS 
CASH-RPT.BAS 
ACCOUNT.CDE 
CHARGE.CDE 
TRANS.DAT 


To help you organize, analyze and verify all of your checking 
account activity, we introduce Part | of the PERSONAL CASH 
FLOW MANAGER. This system lets you maintain a complete 
record of all money deposited to and withdrawn from each of 
your checking accounts. In addition to a record of all individ- 
ual transactions, and an associated running account bal- 
ance, a ledger of income and expense categories that you 
create lets you monitor your personal cash flow by transac- 
tion type. 
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Three main files provide the underlying structure of the 
PERSONAL CASH FLOW MANAGER. The different checking 
accounts that you use are created and maintained in the Ac- 
count File. The different income and expense categories by 
which you will classify all your transactions are created and 
maintained in the Charge Category File. These two files, Ac- 
count and Charge Category, are the reference files of the sys- 
tem. They provide a financial framework to organize the infor- 
mation recorded in the third key file, the Transaction File. 

In this third file you make an entry for every credit or debit to 
each of your checking accounts. In the process of entering a 
transaction you specify the account to which it applies, and 
the type of transaction that it is. These two pieces of informa- 
tion tie every transaction to an account in the Account File, 
and an income/expense category in the Charge Category 
File. By identifying each transaction in this way, at the time itis 
entered, all three files become interlocked in a way that 
makes record keeping, cash flow analysis and account rec- 
onciliation a breeze. 

/n operation, all activity within the PERSONAL CASH FLOW 
MANAGER originates with a choice from the 7 function Main 
Menu. From the Main Menu you'll select ‘Account Mainte- 
nance’’ to create your checking accounts and obtain current 
balance information about them. Selecting ‘‘Charge Catego- 
ries Maintenance”’ allows you to do the same for your income 
and expense categories. Once your account and charge cat- 
egory files have been created, choose ‘‘Transaction Entry & 
Maintenance”’ to add new transactions and modify existing 
ones. When it comes time to reconcile your checking account 
statement(s), select ‘Transaction Reconciliation’’ and verify 
each transaction for the account. Display or print the financial 
information present in any one of the three central files 
through a special submenu for this purpose. Or review the 
contents of all three files simultaneously with the “‘Integrated 
File Display.” All the facilities to enter, maintain and retrieve 
your checking account cash flow activity are at your finger- 
tips with Part | of the PERSONAL CASH FLOW MANAGER. 


START-UP 
In order to use the PERSONAL CASH FLOW MANAGER, you 


must transfer the necessary programs from the PC Disk Mag- 
azine diskette to a diskette with room for the three key data 
files. To do so, put your PC Disk Magazine diskette in the de- 
fault drive and type: 
COPY CASH*.* B: 

where B: is the drive holding a formatted work diskette. The 
two programs comprising the PERSONAL CASH FLOW 
MANAGER, CASH.BAS and CASH-RPT.BAS, will then be 
copied over. 

To start the PERSONAL CASH FLOW MANAGER, load Ad- 
vanced BASIC into your PC by typing: 


BASICA 


then put your working copy diskette in the default drive and 
type: 


RUN “CASH 


For the first use of this program, the computer will automati- 
cally allocate space for the three new files you will be using: 
Accounts, Charge Categories, and Transactions. It will tell 
you it is doing so as it creates them. In future start-ups, the 
first thing you'll see is the title page, followed by the 7 function 
“Main Menu’. 


ACCOUNT MAINTENANCE 

The first thing to do is set up your Account File—the file in 
which your checking account(s) will be maintained. Account 
File Maintenance is selection 2 on the Main Menu, so press: 


2 


An Account Maintenance screen will appear, listing your cur- 
rent records in the right hand column. The left hand portion of 
the screen is used to enter data. At the bottom of the screen 
will appear a five function submenu. The submenu includes: 
Inquiry, Add Record, Alter Record, Delete Record and Go To 
Main Menu. 

Since there is nothing in your account file when you first be- 
gin, you'll have to add information. Push: 


Prompts will then ask you to enter the account category num- 
ber, and account category name. For example, let's number 
this account 1. Type: 


1 
And call the account CIT] CHECK for Citibank Checking. 
Type: 

CITI CHECK 


If you fill a field entirely, the computer will move automatically 
to the next line. In that event, you will not have to press the En- 
ter key following an entry. Directly underneath the account 
name will be listed the current balance for the account. Since 
you have yet to enter any transactions, the balance will be .00 

lf you would like to enter another checking account, just 
enter the new account category number and name. When 
you've completed your additions, or wish to exit the add pro- 
cedure, simply push: 


to return to the Account Maintenance submenu. You may 
then choose another function from the submenu. For exam- 
ple, to look at the new account, select ‘‘Inquiry’’. Push: 


ba] 


Enter the number of the account you wish to review, and the 
account name and current balance for that account will ap- 
pear on your screen along with a new submenu: 
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F1 prior record F2 next record F3 return to menu. 


In inquiry mode you have the ability to ‘‘scroll’’ backward and 
forward through the file. That is to say that once you have lo- 
cated an entry in the file, you can display every preceding en- 
try in sequence back to the beginning of the file, by repeated- 
ly pressing: 


You can display all subsequent entries through to the end of 
the file (i.e., the last entry) by repeatedly pressing: 


To exit the inquiry function, push: 


The previous 5 category submenu will reappear and you can 
either choose to make additional changes, or return to the 
Main Menu. 


CHARGE CATEGORY MAINTENANCE 
Let’s go back to the Main Menu and set up the Charge Cate- 
gory file. Push: 


[=] 


When the Main Menu reappears, type: 
ll 


The Charge Category Maintenance screen will appear in the 
same format and with the same function key submenu as the 
Account Maintenance screen. Let's add a charge category. 


Push: 
Le] 


You'll be asked to enter a charge category number and 
name. For example, enter 1 for the number and call the cate- 
gory ‘“‘Supplies’’. Following these entries you'll be asked to 
identify the charge category as a credit or debit. 

When a charge category is a credit, transactions assigned 
to that category get added to the affected account balance. 
Debit charge categories have the opposite effect on the 
acccount file. Another way of thinking about it is that credit 
charge categories represent money in, debit categories are 
money out. Thus “‘Salary”’ is a credit charge category, while 
“Supplies” is a debit category, because it's money you pay 
out. Since ‘Supplies’ is a debit category, push: 


D 


The entry is now complete, and the prompt returns to the first 
line for an addition, in anticipation of adding another charge 
category. We can continue adding categories, then press: 


at any time to exit add mode and return to the 5 category 
submenu. 

Again, from the submenu you can choose to add, delete, 
inquire, alter, or return to the Main Menu. 

Let’s try a delete. Push: 


You'll then be asked to choose the category you would like to 
delete. Enter the category number. A four function submenu 
will appear on the bottom of your screen. If you would like to 
delete the category currently displayed, push: 


If you would like to go back one record or forward one record 
in the file, press: 


[» Jor[2] 


respectively. Nothing is deleted when you move backward or 
forward in the file. The activity is the same as the scrolling in 
inquiry mode. You simply change the entry currently dis- 
played, and thereby the entry available for deletion. 

When you do delete a charge category, the prompt returns 
to the first line, ready for another deletion. 

If at any time during this procedure or any other procedure 
you would like to exit, just push the ESCAPE key: 


=| 


The ‘‘Alter Record”’ key allows you to go back and change an 
entry. For example, if you misspelled ‘‘Income’’, push: 


Enter the category number where the change is to be made. 


Push: 


If you still want to alter this record, respond to the prompt 
“Enter desired function for inquiry scan’ by pushing: 


The next prompt will ask you to enter the field number adja- 
cent to the line where the change is to be made. Enter the 
number, and then type in the change. 

If you would like to make further alterations, you may, if not 
push the ESCAPE Key to exit to the submenu. Then push F5 
to return to the Main Menu. 


RECORD” 
KEYS 
ALLOW YOU 
TO GO BACK 
AND 
CHANGE 

AN ENTRY. 
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TRANSACTION MAINTENANCE 


A completed transaction entry. 


Now you're ready to enter transactions. Select activity 3 from 
the Main Menu. The Transaction Entry screen will appear with 
the same function key submenu as the two previous mainte- 
nance activities. Push: 


to add a transaction record. 

You'll be asked to enter the number of the Account which 
this transaction should credit or debit. In the current version 
of the CASH FLOW MANAGER all transactions are either 
money into (credits) or money out of (debits) a checking ac- 
count. When the account number is entered, the name of the 
account will appear immediately to the right. Enter the date of 
the transaction, check or transaction number, and the trans- 
action amount. Next, enter the charge category number. For 
example, if this is income, enter 2—the number we assigned 
previously to this category. And finally you're asked to enter 
the name of the Payee/Payer, and a Transaction Memo. 

Below the transaction memo the word ‘‘Reconciled’’ will 
appear with a flashing ‘‘N”’ in the right hand column. Normal- 
ly you'll enter ‘‘N’’ for no unless you are simultaneously enter- 
ing and reconciling a transaction, in which case you will enter 
ary 

If you make an error while entering transaction information, 


push: 
[+] 


and you'll be taken back to step one to reenter transaction 
data. 

When you've completed your transaction entry, the trans- 
action will be posted to your Account and Charge Category 


files, so that the affected balances will be updated 
automatically. 

You've probably noticed that the entry and maintenance 
procedures are the same across all three data files: ac- 
counts, charge categories and transactions. The actions that 
are available, and the keys used to invoke those actions, are 
the same for all three files. Therefore, take the time to experi- 
ment with the different actions and associated key se- 
quences. This will greatly enhance the usefulness of the PER- 
SONAL CASH FLOW MANAGER to you. 


RECONCILIATION 

With the PERSONAL CASH FLOW MANAGER, reconciliation 
is avery simple procedure. Select 4 from the Main Menu, and 
a reconciliation screen will appear. Enter the number of the 
account you want to reconcile and the first transaction in that 
account will appear. Notice the ‘‘Y’’ is flashing on line 8. To 
reconcile this transaction push: 


If you do not want this transaction reconciled, push: 
N 


The next transaction will automatically appear. Continue to 
reconcile until all transactions have been viewed. If you 
would like to exit this procedure before completing reconcili- 
ation of all transactions, you can exit by pushing: 


[is] 


DISPLAY/PRINT 


Whenever you want to look at or print your transaction, ac- 
count or charge category files, select the Printed Report And 
Screen Inquiry function from the Main Menu. Once selected, 
a seven function display menu will appear offering three in- 
quiry display requests, three print requests and an option to 
return to the main menu. 


TRANANSACTION REPORT 


@1-@1-1980 PAGE 1 
DATE TRANS # AMOUNT CATEGORY PRYEE/PAYER MEMO REC 


( 1) CHEM CHECK 


28-Jun-83 @ 1500.0@ ROYALTIES I. M. Publishers Advance on book N 
20-Jun-83 1 750.76 SALARY Paycheck for May 3Q Union fees taken N 
20-Jun-83 1005 8@.@8 HOUSE INS. Aetna Ins. Co. Includes fire insur. N 
28-Jun-83 1006 @0@.8@ APPLIANCES Acme Dept. Store Air Conditioner N 
E@-Jun-B83 1087 66,.@@ ENTERTAIN Star 4 Restaurant Mothers Day N 
28-Jun-83 1008 12.00 DRY CLNERS Best Cleaners N 
( 2)CITI CHECK 
27-Jun-83 @ 1567.75 WKEND WRK Special Assignment N 
@1-Jul-83 1 3@. @2 MISC. My wife Curl Up & Dye beaut. N 
@i-Jul-83 e 45.98 APPLIANCES Apex Appliance Smoke Alarm N 
@1-Jul-83 3 620.2 ROYALTIES VERY BIG CORP. N 
@S-Jul-83 3 5.0% ENTERTAIN Ticketron Concert N 
( S)MONEY MKT 
@2-Jun-83 1 1@09.8@ ROYALTIES VERY BIG CORP. MORE TO COME N 
25-Jun-83 e 65@.@@ ROYALTIES 1. M. Publishers From John Doe N 
27-Jun-83 537.98 CPTAL GAIN Sale of IBM N 
@S-Jul-83 2 3@.@2 TRAVEL Rough Ride Bus Co. N 
iQ-Jul-83 3 25.88 LIQUOR Spirit Town Beer for Weekend N 
SUBTOTALS BY ACCOUNT 
@1-01-1980 PAGE 2 


CODE DESCRIPTION TOTAL 
1 CHEM CHECK 2608. 76 
= CITI CHECK e292. 75 
3 MONEY MKT z 
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Let's have a look at the Charge Categories. Push: 
1 


A Charge Categories report will appear on your screen with 
four columns of information: code number, category name, 
category type (credit or debit) and a balance. A prompt will 
ask you to press any key for display of the next page, or if this 
is the final page, will return you to the Report/Inquiry Menu. 
Push: 


3 


for accounts display. The Accounts Report is similar to the 
Charge Categories report and provides you with the code 
number, name, and balance of each account. Once again, 
you're asked to hit any key to continue. When you return to 
the Report/Inquiry Menu, push: 


5 


The Transaction Report displays three pages of information: 
a Transaction Report, Subtotals by Account, and Subtotals 
by Charge Category. The 6 columns of the Transaction Re- 
port are: date, transaction number, amount, category num- 
ber, payee/payer, memo, and reconciled. Entries are 
grouped according to account number. To go to the next 
page, press any key. Subtotals By Account will appear on 
your screen, providing the account code, description of the 
account, and total money by account. The following screen 
displays Subtotals By Charge Category, and in addition to the 
three columns provided in the Accounts Category, the 
Charge Category includes columns for %Ilncome and 
% Expenses. 

For all selections in the Report/Inquiry Menu, you will be 
returned to that menu following the completion of each 
inquiry. 

The three print selections in the Report/Inquiry Menu allow 
you to print reports of the charge category, account and 
transaction files. 

For a complete look at all of the data you've stored in the 
CASH FLOW MANAGER, on one screen, push: 


6 


from the Main Menu. 


Personal Finance Consolidated vee 
- an 


798.76 
i 


4005 HOUSE 1N8.D Includes fire home 
a 8 F 


} 
Dal 
te 


: taupant 66.00 
1007 ENTERTAIN D Mothers Day Nees i 2 
mana Re i cae 
4 CHEN CHECK) «2 CLIT CHECK| 3 MONEY SIXT | | 
i} 4892.76 | 1967.79 937:98 | | 


T WINDOW BA UP LINE HR DOUN LINE BE) UP PACE bg DOWN PAGE Ref TAIN MENG 
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The integrated file display 
INTEGRATED DISPLAY 


Following the selection of the Integrated File Display, the Per- 
sonal Finance Consolidated Inquiry screen will appear. The 
screen is divided into three windows. The left hand window 
displays transactions, on the right the charge categories are 
-~ displayed, and at the bottom of the screen the account(s) are 
listed. All three data groups are displayed with accompany- 
ing information. 

Below the account window is a six function submenu that 
provides scroll capability. A ‘smile’ indicator, controlled by 
the F1 function key, notes which window the F2 through F5 
function keys will currently operate on. The function keys F2 
and F3 let you scroll the active window up one line and down 
one line respectively. Function keys F4 and F5 move the ac- 
tive window up and down a full window display at a time 
respectively. 

Once you've completed your work on the PERSONAL 
CASH FLOW MANAGER, push: 


7 


from the Main Menu to exit the program. 


SUBSCRIBE NOW 


-~ and save $60 ona 6-issue subscription to PC Disk Magazine. 

Give yourself or a friend up to 72 ready-to-use programs for 

the IBM PC—a library of quality software—all for only $119. 
Write to: 

PC Disk Magazine 

CN 1916 

Morristown, N.J. 07960 

or Call: 

ae 
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Now that you've used the first issue of PC Disk Magazine, 
you'll want to be sure not to miss the upcoming issues. 


Save $60 with this introductory offer and give yourself—or a 
friend—up to 72 programs for as little as $2.00 each. PC Disk 
Magazine is the solution to the problem of building and main- 
taining an up-to-date library of software programs for your 
IBM personal computer. 


You'll get up to 12 varied, ready-to-use programs and files in 
every issue—complete with a comprehensive, illustrated 
User Manual—for the ultimate in ease, efficiency and econo- 
my. Developed by experts and tested by the editors of PC 
Disk Magazine, you'll be able to expand the use of your IBM 
personal computer with your first issue. 


Use the enclosed order card to subscribe today. If the card is 
missing, please write to: PC Disk Magazine, CN 1916, Mor- 
ristown, NJ 07960. Or, if you would like faster service, use the 
toll-free number below. American Express, MasterCard and 
VISA accepted. 


Call 
1-800-5 26-0666 
and get 
6 issues of PC Disk Magazine 
for $119 
a savings of 34%! 


All savings based on full 6-issue subscription price of $179. 
Please allow 6 to 8 weeks for delivery of first issue. 


DISK-MAP 


By Peter Norton 


SpeciaiReguiremeis: Two disk drives. 
Files USa7DISKMAP.@@M 


If you've evergN@Malered exactly where on your diskette infor- 
matiogié st6red where files and remaining free space are, 
whefersysiem information such as the directory, the File Allo- 
catiog’ lable, and the ‘‘boot’’ record are located—DISKMAP 
will bgegwelcome addition to your software library. 
DISKMAP is an element from the Norton Utilities, the widely 
praised library of DOS tools for the IBM PC. DISKMAP will 
display a complete map of the space utilization of your disk- 
ette. A different space diagram format is used for each of the 
four standard diskette formats: eight sector single-sided, 
nine sector single-sided, eight sector double-sided and nine 
sector double-sided. The space diagram illustrates the con- 
tents of all sectors of all 40 diskette tracks. Summary statis- 
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tics are also provided. DISKMAP can produce a color display 
on systems with the color graphics adapter. 


START-UP 

Using DISKMAP is simple. Enter the program’s name, fol- 
lowed by the drive specification of the diskette drive you wish 
to map. For example: 


DISKMAP A 


If you leave off the drive specification, DISKMAP will default 
to the B Drive. The simplest way to use DISKMAP is to put 
your PC Disk Magazine diskette in your A Drive, and the 
diskette to be mapped in the B Drive. Then just type: 


DISKMAP 


The program will display the map of the diskette in the B Drive 
and end execution automatically. 


4 468 sector ven ¥ lint ch space 


i sector given to the boot record _ 
1% 4 sectors given to the file allocation table 
nit _.f Sectors given to the file directory 
27% 156 sector: n to normal files . 
4 6% 44 sectors given to hidden, ieee or eae ty files 
i ilak h CHEDSK) 
fio sectors given to pultioting file space allocation 
fo sectors given to Bad-Track {unusable} 


fio sectors given to unavailable space (free wi 


2349678981.2345678901 23456789 
» . Unused sector (free space) 


loot record — 
File allocation table 
Directo 

. =: In use by a normal file 

: Rides, system, Pead-only 

: ke arity ee 

nflicting allocation 

ad-Track (urusabie) 


The map screen of a nine-sector double-sided diskette. 


THE DISK-MAP SCREEN 

A summary of your diskette space usage appears on the 
top half of your map screen. This usage summary gives you a 
sector count and percent of total for each content category 
such as free space, normal files, system files and directories. 
The bottom half displays a map of the diskette itself with an 
accompanying legend. In addition to displaying used and 
free portions of your diskette, DISKMAP shows any part of 
the disk that is marked off as unusable due to formatting er- 
rors. Temporarily unavailable space and cross-linked files, 
although uncommon, are also pinpointed for you. 


THE MAP ITSELF 

A line between the usage summary and map itself tells you 
what kind of diskette is being mapped. The column headings 
of the map itself represent the 40 tracks of the diskette, num- 
bered 0 to 39. For single-sided diskettes, sector numbers 


(the map rows) are sequential (1 to 8, or 1 to 9). For double- 
sided diskettes, sectors are allocated in pairs, and the map 
reflects this fact. For eight sector double-sided diskettes the 
sector row labels are 1,3,5,7 for Side 0, and the same for 
Side 1. Each sector number actually denotes a pair of sec- 
tors, so that 1 denotes sectors 1 and 2, 3 denotes sectors 3 
and 4, etc., for a total of eight sectors per track on each side 
of the diskette. 

The same concept applies to the map of nine sector dou- 
ble-sided diskettes, but the ninth sector creates a twist. Side 
0 still has sector pairs 1,3,5,7. The ninth sector of Side 0 is 
paired with the first sector of Side 1. Thus the sector pairs for 
Side 1 are listed as 2 (for 2 and 3) 4 (for 4 and 5) etc. The lo- 
cation of 9 (for the 9 and 1 pair) right between the two sides is 
an attempt to illustrate this unique pairing arrangement. 

The accompanying map legend explains the type of infor- 
mation present in each sector. Every diskette, once format- 
ted, has space allocated for a boot record, a File Allocation 
Table, anda Directory. The Directory contains an entry for ev- 
ery file on the diskette, composed of the filename and a point- 
er to its entry in the File Allocation Table. The File Allocation 
Table in turn contains a list of which sectors are used by each 
file on the diskette. ‘Hidden’ files are commonly the two 
DOS operating system programs which the computer puts on 
asystem start-up diskette. These programs do not show up in 
the DIR command; they are loaded by the computer to start 
DOS when you turn on the computer or do a system reset. 
The presence of locations that are ‘‘Temporarily Unavail- 
able”’ (A) or under ‘‘Conflicting Allocation’’ (X) are usually an 
indication that a copy protection scheme is in effect on the 
diskette or that the diskette is damaged. 

Since the display produced by DISKMAP consists entirely 
of printable characters, you can print a copy of the map with 
the PC’s ‘Print Screen’ facility,: 


[alr] 


CALLING ALL PROGRAMMERS!! 


If you have written software for the IBM PC that you feel would 
be of use or interest to others, PC Disk Magazine would like to 
know about it. Publishing is no longer just for poets and pro- 
saists, but now it’s for programmers too. Ask for our Software 
Submission Plan by writing to: 

PC Disk Magazine 

Dept. 732 

One Park Avenue 

New York, N.Y. 10016 


SCREEN” 
FACILITY. 
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= 2 =ERGING THE CODE 


The procedure seems simple. The twist, however, is that if 
there are any matching line numbers in the ASCII file and the 
current BASIC program, these lines of the current BASIC file 
will be replaced when you MERGE. Therefore, before you 
create your ASCII file, you should first eliminate all the extra- 
neous lines in the program with the DELETE command, so 
only the section of interest to you remains in BASIC. Then use 
the RENUMBER command to set new line numbers for this 
extract, line numbers which you know will not conflict with 
those in the destination program. After renumbering, do your 
SAVE to create the ASCIl extract file. Then load your program 
into BASIC and MERGE the extract file in. 

An example using the “Perpetual Calendar” in this issue 
may be helpful. When in BASIC, put the PC Disk Magazine 
diskette in the default drive and type: 


LOAD “PERPCAL 


As discussed in the article on the Perpetual Calendar, the 
three subroutines of interest are in lines 1000-1030, 9100- 
9190 and 9200-9340. So the next step is to delete all extrane- 
ous lines. Type: 


DELETE 1-310 
DELETE 1031-9010 
DELETE 341-9520 


With the deletion done, renumber the extract with a starting 
line number well above any lines in the destination program. 
Type: 

RENUM 10000 


Then save the extract to an ASCII file by typing: 
SAVE “somename”’, A 


Lastly, load your program into BASIC, and merge in the ex- 
tract file. Type: 


LOAD “yourfile 
MERGE “‘somename” 


IBM MATRIX PRINTER CONTROL 


By Roxanne Katt 


Special Requirements: IBM Matrix Printer or equivalent. 
Files Used: PRINTCON.BAS 


To simplify your printing, the IBM MATRIX PRINTER CON- 
TROL allows you to quickly set the eight printing features 
common to all IBM Matrix Printers. You can experiment with 
different printer settings until your printed output looks exact- 
ly as you want. 

You make your feature selections on a single screen. Some 
features require a yes (Y) or no (N) setting, others require a 
numeric value. You can keep changing the settings and trying 
the result while still in the program. When you like what you 
see, exit the program and those settings remain in effect until 
you change them with a program or you reset your printer. 


START-UP 

To start the /BM MATRIX PRINTER CONTROL, first make sure 
that your printer is turned on and is online. Then load Ad- 
vanced BASIC into your PC by typing: 
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BASICA 


Then put the PC Disk Magazine diskette in your default drive 
and type: 


RUN “PRINTCON 


inst Line? = fi Compressed Print? 
Enphasized Print? fi Double Strike Print? 


Form Feed Defeat? 


Spacing? i Horizontal Tab Sp 2 


SETTINGS 0.4.2 _ 


A complete specification of printer feature settings. 


OPTIONS 

The program begins by initializing the eight printer features to 
a set of default values. Once this is done, the control specifi- 
cation screen is displayed, showing the eight printer features 
with their current default settings. The first five features are 
Yes/No settings. A Yes (Y) setting activates the feature. The 
latter three call for a numeric value. The features and their 
meanings are as follows. 

1. Double Width First Line—When activated, prints the 
very nextline sent to the printer, and only that one line, in 
expanded width. 

2. Compressed Print—When activated, reduces the size of 
the characters printed to allow 132 versus 80 characters 
in the same 8-inch page width. 

3. Emphasized Print—When activated, prints boldface let- 
ters. Emphasized Print and Compressed Print are mutu- 
ally exclusive. If both features are activated, Empha- 
sized Print takes priority. 

4. Double Strike Print—When activated, creates print very 
similar to Emphasized Print. 

5. Form Feed Defeat—Only affects printer output contain- 
ing top-of-page control characters (i.e., new page 
codes). When activated, will cause these control char- 
acters to be ignored so that continuous (unpaginated) 
printing results. 

6. Vertical Spacing—Sets the spacing between lines, 
measured in 72nd’s of an inch. Can be set from 1 (145”) 


to 85 (85/75"). 12 is normal, 24 double space, 36 triple 
space, etc. 

7. Lines/Page—tThe printer keeps internal track of the 
number of lines printed since the last top-of-page per- 
formed. When another top-of-page control is received, 
the printer advances the paper a number of lines equal 
to the lines/page less the number of lines printed thus 
far on the page. Thus, the lines/page feature lets you 
adjust to different lengths of paper. Valid settings for 
lines/page are from 1 to 127. If there are no top-of-page 
controls in your transmission to the printer, this feature 
setting has no effect. 

8. Horizontal Tabs—By default tab stops are set eight 
spaces apart (i.e., at columns 8, 16, 24, 32...). The 
number you enter here will specify the interval between 
stops, starting from the column of the number entered 
(e.g., entering 10 would set tab stops at columns 10, 20, 
30, 40...). The program will automatically create as 
many tab stops as will fitin the width of the line (up to 80 
or 132, depending on the Compressed Print setting). 
This feature will have no effect on your output unless 
there are tab control characters in the output stream. 


EXECUTION 

So much for the explanation of the features themselves. Your 
best bet to understand them is to experiment with the effect of 
different settings. The /BM MATRIX PRINTER CONTROL 
takes you through each of the eight features in turn. For all 
features, if you want to leave the current setting unchanged, 
just press: 


when the cursor is positioned at the beginning of the feature 
value. To seta YES/NO feature to YES you must type: 


¥ 


in the field (no following Enter key is necessary). Typing any 
other character will set the feature to a NO value. For numeric 
features, only numbers will be accepted. All numeric entries 
must be concluded with the Enter key. Values above or below 
acceptable limits will restore the field to blanks and return the 
cursor to the beginning of the field for re-entry. No message 
appears. 

Each time you go through the list of settings, the program 
will ask if the settings are okay. If you enter any character ex- 
cept Y for YES, you will return to the first feature setting to go 
through the list again. If you confirm that the settings are 
okay, you will be asked if you want to see three sample print 
lines. Answering Y for YES will produce three lines on your 
printer, and you will be asked again if the settings are okay. If 
you don’t want any sample print, or you already know the 
seitings are okay and you're ready to exit the program, then 
answer N for No to the sample lines question, and you will 
end execution of the /[BM MATRIX PRINTER CONTROL pro- 
gram, with the latest printer settings in effect. 
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What sets PC Disk Magazine apart from most other publica- 
tions is that we want and need your direct involvement. That’s 
why we developed the ‘Software Submission Plan.”’ If you're 
interested in submitting software you've developed either on 
your own or with others, let us Know, and we’ll send you the 
Submission Plan booklet. We would like to give you an out- 
line of our Submission Plan here in order to stimulate your 
imagination and your interest. 

The Software Submission Plan provides an opportunity for 
software authors to profit directly from their work. Under the 
plan, PC Disk Magazine pays every published author a royal- 
ty on every issue sold, which contains a copy of his or her 
software. Best of all, this opportunity comes without elabo- 
rate restrictions. Our desire is to license software for publica- 
tion only for the disk magazine format. 

To explore the considerable opportunities for publication in 
PC Disk Magazine, write to us and ask for a Software Sub- 
mission Plan booklet. The address is: 

PC Disk Magazine 

Dept. 732 

One Park Avenue 

New York, NY 10016 
Once you've received the Submission Plan, read it over care- 
fully. If you feel your software fits the requirements set out in 
the plan, complete the enclosed Software Submission 
Agreement and return it to us. No program code or documen- 
tation should be sent along with the Submission Agreement. 

Following receipt of the Submission Agreement, the edi- 
tors of PC Disk Magazine will evaluate the submission. At that 
point, we'll either indicate a lack of interest in the software or, 
if we are interested, we'll issue a submission authorization 
number and ask you to provide us with an executable copy of 
the program along with documentation on 51/4,” diskettes. 
Again, no material should be sent until you receive a submis- 
sion authorization number. 

If we subsequently decide that we would like to publish the 
software in PC Disk Magazine, we will offer a Software Con- 
tract, which will include such items as royalties, advances, 
and program and documentation changes required (if any). 
You will be asked to complete and test any program modifi- 
cations agreed to in the Software Contract, and PC Disk Mag- 
azine will conduct a formal validation of the program and 
documentation. 

We estimate that this process, from our initial evaluation to 
publication, takes approximately 3 to 6 months. This estimate 
is dependent upon a number of factors, and the process may 
take more or less time for your submission. 

We look forward to hearing from you. 
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HIDE AND SINK 


By Mirror Imag oftware In 


‘Color, itor and Adapter. 


pry 


|e) 
ion is to locate and destroy the enemy fleet, 
the safety of your own ships. 


irst hide your fleets and then proceed to alter- 
e horizontal and vertical sea-grid coordinates 
are used to specify positions for hiding ships and taking 
shots. Although your ships are shown on your grid, the com- 
puter cannot see them; just as you cannot see the enemy 
Ships. 

HIDE AND SINK offers three games of increasing com- 
plexity: STANDARD HIDE AND SINK, SUPER HIDE AND 
SINK, and SUPER-SALVO HIDE AND SINK. Each game can 
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also be played with a Nighttime option, which increases the 
difficulty of finding the position and type of enemy ships. 


GETTING STARTED 
To start HIDE AND SINK, first load Advanced BASIC into your 


PC by typing: 
BASICA 


Then put your PC Disk Magazine diskette in the default drive 
and type: 


RUN “HIDESINK 


After display of the title page, you will be asked whether you 
want to play with sound on. You are then asked which of the 
three game options you want to play, and finally, whether you 
want to play with the Nighttime feature. 


YOUR SHIPS Sapa eae 
HIDE & SINK 


CCeeC 
CLCBCeC 
SCC EH 


i 
2 
ei 
4 
a] 
5 
8 
3 
oT+ 


1 


The game screen—battle in progress. 


THE GAME SCREEN 
After you have selected your options, the game screen will 
appear. Observe the two opposing 10-by-10 sea grids each 
labeled with numbers 1-10 down the left and letters A-J 
across the top. Positions on the grids are located using a 
number/letter combination, such as 2D or 9G. 

Under each grid, the five ships in the fleet are on status dis- 
play. Each ship is a specific length and possesses a certain 
amount of firepower. 


SHIP LABEL LENGTH FIREPOWER 
PT Boat PR 2 2 missiles 
Submarine S 3 3 missiles 
Destroyer D 3 1 gun 
Cruiser C 4 2 guns 
Battleship B 5 3 guns 


When a ship is hit or sunk or missiles are fired, the corre- 
sponding ship status display illustrates the action. For exam- 
ple, flames appear on the ship status display where it has 
been hit; missiles are shown firing from a PT boat or Subma- 
rine; and when a ship is sunk, a large X crosses out the ap- 
propriate status display. On the grids themselves, a ship’s 
colored label letter appears in the coordinate where the ship 
was damaged. 

Beneath the fleet status display is the prompt area where 
questions, warnings, and instructions help guide you through 
the game. The first message tells you that the enemy fleet is 
being hidden. It is then the home fleet's turn to hide. 


HIDE... 

You hide your ships, one by one, on the left sea-grid. A 
prompt will ask you to enter a number/letter combination for 
one end of the PT boat first. For example, to locate the PT 
boat near the center of the grid, type: 


5E | | 


A marker (X) will appear in the position indicated and another 
prompt will ask if you would like the ship to extend either 
down (D) or to the right (R) of the marked location. For exam- 
ple, to orient the ship horizontally, type: 


RZ] 


After this entry the ship’s label letter will show where on the 
grid the ship is anchored. You will not be able to extend the 
ship to the left or upward of the marker. Additionally, once this 
initial number/letter combination has been entered, you can- 
not change it. 

Hide the rest of your fleet in the same manner. Error mes- 
sages and prompts for each ship help you through the pro- 
cess. After hiding the last ship (the Battleship), it is the home 
fleet's turn to commence firing. 


oeeAND SINK 

Your home fleet starts the battle by entering a number/letter 
location on the enemy’s sea grid. The shot is marked at that 
position. You may continue entering shots and firing missiles 
as long as you are prompted. All shots ina single turn are list- 
ed between the opposing grids. When firing a missile you will 
have to specify whether the PT boat or the Submarine is 
launching the missile. Once a shot has been entered, it may 
not be changed. 

When your turn is over, the enemy fires at the home fleet 
grid and appropriate markers will appear. After all shots from 
both fleets have been fired, the markers locating the shots will 
land one by one, either in the water or ona ship. Appropriate 
markers will indicate whether the shot was a hit or miss. 

The entire length of a ship must be ablaze for it to be sunk. 
For instance, it takes three hits to sink a Destroyer. 


TO BE SUNK. 
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THE GAMES 
STANDARD HIDE AND SINK 

a. Each fleet has only one shot each turn. 

b. Missiles on Submarines and PT boats cannot be used. 

c. Play ends when either fleet is entirely sunk. 

d. The winner must have at least one gun or missile still 
afloat. 

SUPER HIDE AND SINK 

a. Each fleet may shoot only one gun each turn. 

b. One missile may be fired each turn if desired. Only five 
missiles are available, so use them with discretion. 
Once the missiles are used up the Submarine and PT 
boat are helpless. 

c. Guns and missiles are destroyed when hit and may not 
be used for the remainder of the game. The status dis- 
play will indicate whether any weaponry was damaged. 

d. Play ends when all firepower in either fleet is destroyed 
or used up. All ships need not be sunk, just put out of ac- 
tion. A ship is out of action when its missiles are used up 
or all its missile launchers and guns are disabled. 

e. The winner must have at least one gun or missile afloat. 

SUPER-SALVO HIDE AND SINK 

a. Each fleet shoots all able guns each turn. Initially, each 
fleet has six guns afloat so you may enter at least six 
shots your first turn. 

b. As many missiles as desired (or that remain afloat) may 
be fired each turn. 

Again, be frugal with missiles; once used, the Subma- 
rine and PT boat are helpless targets. 

c. Firepower destroyed may not be used for the rest of the 
game. 

d. Play ends when either fleet is totally defenseless. All 
ships need not be sunk. 

e. The winner must have at least one gun or missile afloat. 


NIGHTTIME 

The Nighttime feature impairs you and your fleet and adds 
guesswork to the game. Hits on enemy ships are not record- 
ed on the enemy’s status display. On the sea grid, hits are 
shown with a blue cloud of smoke, but not marked with a col- 
ored label letter. This makes the game more difficult as you 
cannot see what ship or where on it a hit was scored. There- 
fore, more shots are used up trying to locate the remainder of 
a damaged ship. Once sunk, however, the ship will be X’ed 
out. Enemy missiles are not displayed when fired. So it’s up 
to you to keep track of the number of missiles fired and from 
which boat you think they came. 

Your status is always displayed, but the computer enemy 
does not have this knowledge; so the same conditions apply 
for both fleets. 

To end the game at any time, press: 


Scroll 


and you will be returned to BASIC. 


AMES 


PYRAMID MATCH 


By Paul Somerson 


Special Requirements: None 
Files Used: PYRAMID.BAS 


Here’s a game in which you'll be competing against time— 
and patience. The question is, which will run out first? It re- 
quires speed, a superb memory, and a remarkable level of 
accuracy. One slip and the game’s over. But, you're in luck, 
it’s geared for beginners as well as superhumans. It’s called 
PYRAMID MATCH. After a few hours of play, you may be 
tempted to call it something else. 

Here’s how it works. You're presented with an ever-in- 
creasing list of numbers starting with a single digit and build- 
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ing play by play to a string of digits longer than you can re- 
member. And you have to remember them. After the line of 
digits is presented to you, you've got to type them in on your 
keyboard. If this is done correctly, you'll proceed to the next 
line in the ever growing pyramid. And don’t forget the clock is 
always running. 

The game continues until you enter an incorrect number, or 
run out of time. Depending upon which level of difficulty you 
choose, you have anywhere from 10 to 90 seconds in which 
to play the game. 


START-UP 
To start, load Advanced BASIC into your PC by typing: 


BASICA 


Then put your PC Disk Magazine diskette in the default drive 
and type: 


RUN“PYRAMID 


The title screen will appear with the request: “‘Hit any key to 
continue.”’ (This is the easy part.) If you have a color graphics 
adapter, you will be asked if you want to play in color. For col- 
Or or monochrome play you are then asked if you want silent 
play, and finally if you want instructions. 

Following the instructions request prompt, you select a lev- 
el of difficulty. If you have never played before, choose cate- 
gory 1, ‘Drooling Infant.”’ If you consider yourself a real ex- 
pert at number games, you might try going for number 10 
(only ten seconds in which to win the game), ‘‘Visitor from an 
Advanced Civilization.”’ If you manage to get to level 10 of the 
pyramid, check your birth certificate. You may very well be a 
visitor from another planet! 

Your choice of the level of difficulty determines three key 
features of the game: the amount of time you have to play, the 
length of exposure for each number, and the starting point 
value for your guesses. The higher the level of difficulty, the 
less time you have to play—10 seconds less for each higher 
level of difficulty, from a maximum of 90 seconds to a mini- 
mum of 10. Similarly, the higher the difficulty level the shorter 
the exposure time for each guess number. Lastly, the starting 
point value for your guesses goes up 20 points for each high- 
er level of difficulty, from a minimum of 130 points for a first 
guess to 290 points. Once the game is underway, whatever 
the level of difficulty, each succeeding level of the pyramid is 
worth 10 points more than the preceding level, and each re- 
quest to see a number again (explained further below) sub- 
tracts 25 points from your score. 


94 
599 
4036 
23796 
530089 
8375426 
87896104 
884474670 


The game screen—a level 9 achievement. 


THE GAME SCREEN 

Once you've selected a level of difficulty, the game screen 
will be displayed. The upper left-hand box lists the high score 
for the playing session in progress (not the highest score 
ever, only for the current series of play), the difficulty level, the 
level of the pyramid you're on (at the beginning of the game it 
will register 1), and your score. The right-hand box notes that 
you should enter the correct number(s) following the flash on 
your screen. Numbers will only be displayed for a brief in- 
stant, so pay attention. But, you can see the number again by 
pressing: 


le 
>| 


the Tab key. That will start the current level over again by 
redisplaying the number for that level. There’s a catch. Every 
time you ask to see a line of the pyramid again, you lose 25 
points. 

At the start of each game you'll see a countdown (begin- 
ning with 160) in the box at the bottom of the screen. During 
this countdown the computer is generating the pyramid num- 
bers for the game to be played. When the count reaches 0, 
the first number of the pyramid will appear at the top center of 
the screen. Enter that number. As you enter numbers correct- 
ly, new numbers will be presented to you until you make a 
mistake or run out of time. The clock is displayed in the same 
box as the countdown at the bottom of the screen. To spice 
up the game, you may consider playing a series to see who 
can get the highest cumulative score in a time interval span- 
ning several rounds of the game. Use strategy to select your 
highest scoring combination of difficulty levels. 

When the game is over, you have the option of a replay (R), 
or quit (Q). It won’t be long before you wish there was a kill 
option as well. Good luck. 
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DEMOGRAPHIC DATA FILE 
By U.S. Census Bureau 


Special Requirements: None 
Files Used: DEMOSTAT.DAT 
DEMOREAD.BAS 


If you've ever wondered what the odds are of getting di- 
vorced in New Jersey, what the likelihood is of being poor in 
lowa, how many people live on the same square mile of land 
you're thinking of living on in Colorado, or what the odds are 
of meeting that special person in Oklahoma, THE DEMO- 
GRAPHIC DATA FILE is for you. It’s an ideal tool for students, 
planning professionals, and curious home users. 

THE DEMOGRAPHIC DATA FILE provides 15 items of de- 
mographic information by state, from the official 1980 U.S. 
Census. In addition to the data file itself, there is a small pro- 
gram that reads the data into memory. With this program you 
can look at and manipulate the demographic statistics, as 
well as use the data in your own program. 


BACKGROUND 


The name of the file containing the demographic data is 


DEMOSTAT.DAT. There is a one-line entry in this file for every 
state, plus the District of Columbia. The information for each 
state, in order, is as follows. 
1. U.S. Post Office State abbreviation. 
2. 1980 population (in 000's). 
3. % change in population, 1970-1980. 
4. Population density (people/square mile). 
5. 1980 Population % male. 
6. 1980 Population % urban. 
7. 1980 Over-25 Population % with college degrees. 
8. Median age. 
9. # of people below poverty level (in 000’s). 
10. Married spouse households (in 000’s). 
11. Single spouse households (in 000’s). 
12. Non-married households (in 000’s). 
13. # occupied housing units (in 000's). 
14. Per capita income, 1980 dollars. 
15. Median monthly mortgage costs (owner-occupied, 
noncondominium, single family houses). 
16. Median monthly rent. 
These data items are always in the same order for each state; 
the states themselves are in no particular order. These data 
items are separated by commas within the file. There is a car- 
riage return at the end of the line for each state, and all of the 
data is stored as standard ASCII characters. Thus, you can 
print the file DEMOSTAT.DAT, or call itinto a standard editor, 
if you want to see the data itself. However, the absence of 
spaces in the file makes it very hard to read. To retrieve, ma- 
nipulate, and report this demographic data, you would do 
well to use the accompanying program DEMOREAD. 
DEMOREAD is a very simple BASIC program. All it does is 
read the data present in DEMOSTAT.DAT into two variables: 
STATE$ and STATS. The first variable, STATE$, is a 51 ele- 
ment character array, which receives all the two-letter state 
abbreviations when the data file is read. STATS is a 5 1-by-15 
single precision numeric array which receives the 15 demo- 
graphic statistics for each state when the data file is read. 
DEMOREAD fills one other variable, LABEL$. This 15 ele- 
ment character array is filled with a short label for each of the 
15 demographic items. These labels are not in the data file. 
They are in the DEMOREAD program itself in a DATA state- 
ment from which they are read into LABEL$. 


START-UP 
To execute DEMOREAD, load Advanced BASIC into your PC 


by typing: 


BASICA 


Then put the PC Disk Magazine diskette in the default drive 
and type: 


RUN “DEMOREAD 


The screen will be cleared and the program will tell you it is 
“READING DATA.” When the reading process is complete 
you will see the message ‘‘DEMOGRAPHIC DATA FILE 


FILE IS READ 
INTO 
MEMORY. 
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READ.” The three key variable arrays, STATE$, STATS, and 
LABELS are now filled. 


ACCESS 
You can now work with these variables in BASIC’s Direct 
Mode. For example, type: 


PRINT LABELS (7), STATES (32), 
STATS (32,7) 


and you will see the label ‘Median Age”’ followed by the state 
abbreviation ‘‘TN”’ followed by the median age for the state of 
Tennessee. You can display and manipulate any of the de- 
mographic data directly with these three variables. 

To do more elaborate manipulation and display, you will 
probably want to include DEMOREAD as a subroutine in your 
own program. To do so, simply change the END on line 210 
toa RETURN, renumber the program as necessary, and save 
itas an ASCII file by typing: 


SAVE “somename”,A 


Before executing this SAVE command you should replace 
the PC Disk Magazine diskette with a work diskette so there 
will be space available for the saved file. You can then merge 
DEMOREAD as a subroutine into your own program at any 
time by typing: 


MERGE “somename 


Profile of Household Types by State 
Data from 1388 Census 
TOTAL 
STATE HOUSEHOLDS % MARRIED % SINGLE % NON-MARRIED 
me S41 8.3 18.7 73.2 
NH 443 7.9 19.2 72.3 
VT 247 Tt 20.2 72.1 
Ma 2902 9.5 2e.4 72.2 
RI 477 9.4 19.5 7i.1 
cT 1se3 3.9 18.3 71.8 
NY se42 10.6 20.8 68.6 
NI 3537 10.5 17.4 72.1 
PA S8se 9.2 18.4 72.4 
OH S267 8.6 418.6 72.8 
IN 2621 8.6 17.9 73.5 
Tt S745 12,2 19.4 72.4 
MI 4428 9.7 18.1 72.2 
WI 2257 7.8 19.6 73.2 
MN 1989 6.9 20.4 72.6 
1g 1425 6.3 19.8 73.9 
mo 2481 8,3 19.4 72.3 
ND 338 6.2 19.8 74.0 
SD 33a 6.7 19.7 73.6 
NE Tai 6.5 22.4 73. 
KS 1191 6.9 19.9 73.2 
DE 288 18.1 18.1 71.9 
MD et6e 11,2 18.0 72.9 
bE 430 12.5 ere 7 58.8 
VA 2577 9.6 18.1 7223) 
wy S922 8.6 17.8 74.4 
NC 2797 10.2 16.7 73.8 
sc 1484 1@.8 15.48 73.4 
GA 2596 lit 16.8 72.1 
FL S235 8.4 20.0 71.5 
KY 1697 9.3 16.3 74.4 
™N 2209 18.0 6.7 73.3 
AL 163 12.3 16.5 73.3 
MS 1144 11.7 16.3 72.3 
AR 1103 8.7 17.3 74.9 
La 1965 18.8 17.4 41.9 
OK 1519 7.2 BG PS 73.7 
Tk €769 8.8 18.4 72.8 
mT 387 6.7 13.9 73.4 
1D 430 6.7 17.9 75.3 
WY 23 5.8 19.7 74.4 


Using the data in one’s own program—a sample report. 


=OMING UP 


DISK LABEL 
Program by Peter Norton enabling you to add/modify/delete 
label on any diskette. 


DISK INVENTORY 
Lets you maintain an integrated inventory of the files on all 
your diskettes. 


DIRECTORY LISTER 
Sort the file directory for any diskette on any characteristic 
(name, extension, etc.). Display or print sorted list. 


BASIC CROSS REFERENCE 

Comprehensive technical reference for BASIC programs 
with variable lists and line locations, subroutine invocation 
and entry points, and more. 


PERSONAL CASH FLOW MANAGER - Part Il 
Adds handling of other cash accounts (credit cards, savings) 
and inter-account transactions, as well as maintenance of 
historical records. 


ENCRYPT/DECRPYT 
Program to protect programs and data by one of two 
encryption methods. 


LEASE/PURCHASE MODELER 
Compare lease/purchase alternatives with present value 
calculations. 


CHECKERS 


Play checkers against the computer. 


PANGO 


An arcade-style action game requiring manual speed and 
coordination. 


SUBSCRIBE NOW 
and save $60 on a 6-issue subscription to PC Disk Magazine. 
Give yourself or a friend up to 72 ready-to-use programs for 
the IBM PC—a library of quality software—all for only $119. 
Write to: 

PC Disk Magazine 

CN 1916 

Morristown, N.J. 07960 


1-800-526-0666 


or call: 
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(To Be Completed by the Household’s Primary User of the Magazine) 


The questionnaire below is designed to help the editors of PC’ Disk Magazine shape its editorial content to be of 
greater interest to its audience. Therefore, we would appreciate your filling in the questions below and returning this 


form in the envelope provided. 6-1 
1. How long have you been involved in microcomputing? _____ years or ______ months (7-9) 
2. Please provide the following information about the microcomputer you plan to use PC Disk Magazine programs 


for. 


Manufacturer (iGa12) 

Model 

Memory Capacity (18218) 

Number of disk drives: (16) Are they: '”' [] Single sided 1] Double sided 


Is the disk operating system: 1] DOSlA 2] DOS2.0 [] Other (Specify) 


Are the display adapters: (Check all that apply) 181 [|] Monochrome [| Color/graphics 


A. Which of the following do you use with this computer? (Please check all that apply.) For each that you use, 
please indicate manufacturer and model. 


Use 
Hand disk 01] Manufacturer Modal oe 
En eins : : Manufacturer. Model (24-26) 
ifunction boar z a 
None of the above aT] Manufacturer Model 
B. Do you haveamodem? Yes **' [_] What is its speed? 3-1] 300 bps 21] 1200 bps 
No?[] 


How do you use this microcomputer? (Check all that apply.) 


321 ["] At home for personal purposes (not games) 
-2[ | At home for business/professional purposes 
[| At home for educational purposes 
4 {| At home for entertainment purposes 
5] At office/place of work 
“6 [| At school 


Which of the following types of applications software do you currently use with this microcomputer? (Check all 
that apply.) 


33-1 [7] Accounting {| Programming languages 

? [| Payroll 8 [|] Graphics 

3 [_] Modelling/forecasting 9 [| Education/training 

-4[-] Other business application -0[ |] Household accounts 

[| Word processing *(/] Entertainment 

6 [| Portfolio management/analysis + {-] Other (Specify) ($4) 
Is this microcomputer owned by you/a member of your household? 

351 |] Yes 2T] No 
A. How long ago did you purchase or receive your copy of PC Disk Magazine? 
weeks 2 = “days 6s?) 
B. How did you get this copy of PC Disk Magazine? 
38-1 [7] Subscription 2 [| Computer store [7] Book store 4 [| Newsstand 
51] Gift 6 [|] Other (Specify) 


A. Why did you decide to purchase (or subscribe to) PC Disk Magazine? 
9°1 ["] Wanted to sample a variety of programs 
{| Had some specific program(s) in which I was interested 
“3[/] Just curious about it 
41] Received as a gift 


10. 


12. 


B. What other reasons did you have for deciding to purchase (or subscribe to) PC Disk Magazine? 


42- 


C. In general, do you think a disk magazine is a good idea, or a poor idea. Please circle the appropriate number 


Ree sensdadas.: f. «Ae 6 2e. ie. a cpaenases 


A. We would like to get your reactions to each of the various programs in PC Disk Magazine. First, please indicate 
which of the programs you have tried. (Please check all that apply.) 


B. Thinking about your microcomputing activities and interests, which of the following programs are most 
important to you? (Please check all that apply.) 


G. For each of the programs you have tried, please rate your satisfaction with the quality of that program. Give a 
program a ‘'5” if you are very satisfied with it, give it a ‘'1" if you are very dissatisfied and give it a 4”, “3” or 


“2" to indicate ratings in between. For Each Program Tried, Are You: 
Most Very Very 
Have Important Satisfied Dissatisfied 
Tried Programs 6) 4 3 2 1 
Loan Analyzer 44-1 [a 45-1 C] im C] [] ei (46) 
Automatic Bar Charter 2 ma L] C] [eel j=] 47) 
WordStar Configurator 2 a C] ie [iF E] (48) 
Basic Program Editor 4 : C] (Fal CJ (sj (89) 
Perpetual Calendar 2 >| S| LJ [eas] [a] E] (60) 
Personal.Cash Flow Manager e “8 [ed] [re C] i C] 61) 
Disk Map Bea ae LE] [ia] [| [sy (62) 
IBM Matrix Printer Control 6 s L] L] [| C] (68) 
Demographic Data File s acaba [=] [| L] L] (64) 
Hide and Sink O,[-] =o. [SI C] ry [ea [z4 (65) 
Pyramid Match E(t] 2) [al im im LJ 68) fia] 
What kinds of programs would you like to see included in future issues of PC’ Disk Magazine? 
57- 
58- 
59- 
How would you rate PC Disk Magazine on each of the following? 
Excellent Good Fair Poor 
The variety of programs included [ied] S a | 1 ype” 
The quality of the programs included +(e] > [el aa 1 aeY 
The quality of the documentation s [sl Ail = [] 1 feysee 
(The following information is asked for classification purposes only) 
A. What is your sex? 63-1 |] Male 21 | Female 
B. What is your age? years (64.65) 
C. What is the highest level of education you have attained? 
66-1 |] Did not (yet) graduate from high school [| Post graduate study; no advanced 
{| High school graduate degree (yet) 
*3[] Attended (attending) college; did not (yet) graduate ~[] Master’s degree or equivalent 
41] College graduate -7[] Doctorate 


D. Aside from yourself, which other members of your household, if any, will use PC’ Disk Magazine programs? 
(Please check all that apply). 


Will use Will use 
Male head of household SEV isl Child, age 18 or older Sal 
Female head of household =r P| Child, age 15-17 il 
Other adult el Child, age 12-14 0) [| 
Child, under 12 years of age ei] 


E. What is your best estimate of your household's 1982 pre-tax income? Please include income of all household 
members from all sources (rents, dividends, wages, etc.) in your estimate. 


68-1 [| Under $15,000 * [| $55,000-$64,999 
[| $15,000-$24,999 7T | $65,000-$74,999 
[| $25,000-$34,999 [| $75,000-$99,999 
41] $35,000-$44,999 °° | $100,000 and over 
51] $45,000-$54,999 (If $100,000 or more, specify amount) (69-71) 


THANK YOU FOR YOUR COOPERATION. 


(8/83) 


Save $60.00 


ALLIBRARY OF SOFTWARE PROGRAMS FOR THE ITIZI PERSONAL COMPUTER 
Py = ~= 


YES! Send me 6 issues of PC Disk Magazine 
for just $119.00—34% off the full subscription price 
of $179.00. 

Check One: 


lalkenclose:$2= = = 
(Residents of CA, CO, CT, DC, FL, IL, MA, MI, MO, NJ, NY 
State, and VT add applicable sales tax.) 


[_] Bill me later. 


[_] Charge my: [] American Express 
[_] MasterCard [] Visa 


Card No. 


5000 


Exp. Date 
Mr./Mrs./Ms 
Address_ 
City. 
States: Se Se Zip 


Offer valid in U.S. and its possessions only. Please allow 30 to 
60 days for delivery of first issue. 


(please print full name) 
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